Policy States - Next Link

Служба:: Policy

Версия API:: 2024-10-01

Последующие вызовы записи к следующей ссылке

POST https://management.azure.com{nextLink}?Next paging op for policy states&api-version=2024-10-01

С использованием необязательных параметров:

POST https://management.azure.com{nextLink}?Next paging op for policy states&api-version=2024-10-01&$skiptoken={$skiptoken}

Параметры URI

Имя	В	Обязательно	Тип	Описание
nextLink	path	True	string	Следующая ссылка для операции списка.
api-version	query	True	string	Версия клиентского API.
$skiptoken	query		string	Skiptoken предоставляется только в том случае, если предыдущий ответ вернул частичный результат в составе элемента nextLink.

Ответы

Имя	Тип	Описание
200 OK	PolicyStatesQueryResults	Результаты запроса.
Other Status Codes	QueryFailure	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Query latest at resource group level policy assignment scope with next link

Образец запроса

HTTP

POST https://management.azure.com{nextLink}?Next paging op for policy states&api-version=2024-10-01&$skiptoken=WpmghrfhqlwpqqdrwpwmgWfBSvPhkAK6QD

Пример ответа

Код состояния:: 200

{
  "@odata.context": "https://management.azure.com/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest",
  "@odata.count": 2,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T17:41:47Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myrg1/providers/microsoft.insights/autoscalesettings/mytest1",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/1ef5d536aec743a0aa801c1a",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/022d9357-5a90-46f7-9554-21d30ce4c32d",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/microsoft.insights/autoscalesettings",
      "resourceLocation": "westus",
      "resourceGroup": "myrg1",
      "resourceTags": "tbd",
      "policyAssignmentName": "1ef5d536aec743a0aa801c1a",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "022d9357-5a90-46f7-9554-21d30ce4c32d",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/335cefd2-ab16-430f-b364-974a170eb1d5",
      "policySetDefinitionName": "335cefd2-ab16-430f-b364-974a170eb1d5",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "15521232277412542086",
      "complianceState": "NonCompliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ]
    },
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T17:41:47Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myrg1/providers/microsoft.insights/autoscalesettings/mytest1",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/186044306c044a1d8c0ff76c",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/022d9357-5a90-46f7-9554-21d30ce4c32d",
      "effectiveParameters": null,
      "isCompliant": true,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/microsoft.insights/autoscalesettings",
      "resourceLocation": "westus",
      "resourceGroup": "myrg1",
      "resourceTags": "tbd",
      "policyAssignmentName": "186044306c044a1d8c0ff76c",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{\"allowedLocations\":{\"value\":[\"centralus\"]}}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "022d9357-5a90-46f7-9554-21d30ce4c32d",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "",
      "policySetDefinitionName": "",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "",
      "complianceState": "Compliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ]
    }
  ]
}

Определения

Имя	Описание
ComponentStateDetails	Сведения о состоянии компонента.
Error	Определение ошибки.
ExpressionEvaluationDetails	Сведения об оценке выражений языка политики.
IfNotExistsEvaluationDetails	Сведения об оценке эффекта IfNotExists.
PolicyEvaluationDetails	Сведения об оценке политики.
PolicyState	Запись состояния политики.
PolicyStatesQueryResults	Результаты запроса.
QueryFailure	Ответ на ошибку.

ComponentStateDetails

Объект

Сведения о состоянии компонента.

Имя	Тип	Описание
complianceState	string	Состояние соответствия компонентов.
id	string	Идентификатор компонента.
name	string	Имя компонента.
timestamp	string (date-time)	Метка времени оценки соответствия компонентов.
type	string	Тип компонента.

Error

Объект

Определение ошибки.

Имя	Тип	Описание
code	string	Код ошибки конкретной службы, который служит подстатусом для кода ошибки HTTP.
message	string	Описание ошибки.

ExpressionEvaluationDetails

Объект

Сведения об оценке выражений языка политики.

Имя	Тип	Описание
expression	string	Выражение вычисляется.
expressionKind	string	Тип вычисляемого выражения.
expressionValue	object	Значение выражения.
operator	string	Оператор для сравнения значения выражения и целевого значения.
path	string	Путь к свойству, если выражение является полем или псевдонимом.
result	string	Результат оценки.
targetValue	object	Целевое значение для сравнения со значением выражения.

IfNotExistsEvaluationDetails

Объект

Сведения об оценке эффекта IfNotExists.

Имя	Тип	Описание
resourceId	string	Идентификатор последнего вычисляемого ресурса для эффекта IfNotExists.
totalResources	integer	Общее количество ресурсов, к которым применимо условие существования.

PolicyEvaluationDetails

Объект

Сведения об оценке политики.

Имя	Тип	Описание
evaluatedExpressions	ExpressionEvaluationDetails[]	Сведения о вычисляемых выражениях.
ifNotExistsDetails	IfNotExistsEvaluationDetails	Сведения об оценке эффекта IfNotExists.

PolicyState

Объект

Запись состояния политики.

Имя	Тип	Описание
@odata.context	string	Строка контекста OData; используется клиентами OData для разрешения сведений о типе на основе метаданных.
@odata.id	string	Идентификатор сущности OData; всегда задано значение NULL, так как записи состояния политики не имеют идентификатора сущности.
complianceState	string	Состояние соответствия ресурса.
components	ComponentStateDetails[]	Записи соответствия состояния компонентов заполняются только в том случае, если URL-адрес содержит предложение $expand=components.
effectiveParameters	string	Эффективные параметры назначения политики.
isCompliant	boolean	Флаг, который указывает, соответствует ли ресурс назначению политики, с которым он был оценен. Это свойство устарело; Вместо этого используйте ComplianceState.
managementGroupIds	string	Разделенный запятыми список идентификаторов групп управления, представляющих иерархию групп управления, в которой находится ресурс.
policyAssignmentId	string	Идентификатор назначения политики.
policyAssignmentName	string	Имя назначения политики.
policyAssignmentOwner	string	Владелец назначения политики.
policyAssignmentParameters	string	Параметры назначения политики.
policyAssignmentScope	string	Область назначения политики.
policyAssignmentVersion	string	Вычисляемая версия назначения политики.
policyDefinitionAction	string	Действие определения политики, т. е. эффект.
policyDefinitionCategory	string	Категория определения политики.
policyDefinitionGroupNames	string[]	Имена групп определений политик.
policyDefinitionId	string	Идентификатор определения политики.
policyDefinitionName	string	Имя определения политики.
policyDefinitionReferenceId	string	Идентификатор ссылки для определения политики внутри набора политик, если назначение политики предназначено для набора политик.
policyDefinitionVersion	string	Вычисляемая версия определения политики.
policyEvaluationDetails	PolicyEvaluationDetails	Сведения об оценке политики.
policySetDefinitionCategory	string	Категория определения набора политик, если назначение политики предназначено для набора политик.
policySetDefinitionId	string	Идентификатор определения набора политик, если назначение политики предназначено для набора политик.
policySetDefinitionName	string	Имя определения набора политик, если назначение политики предназначено для набора политик.
policySetDefinitionOwner	string	Владелец определения набора политик, если назначение политики предназначено для набора политик.
policySetDefinitionParameters	string	Параметры определения набора политик, если назначение политики предназначено для набора политик.
policySetDefinitionVersion	string	Вычисляемая версия определения набора политик.
resourceGroup	string	Имя группы ресурсов.
resourceId	string	Идентификатор ресурса.
resourceLocation	string	Расположение ресурса.
resourceTags	string	Список тегов ресурсов.
resourceType	string	Тип ресурса.
subscriptionId	string	Идентификатор подписки.
timestamp	string (date-time)	Метка времени для записи состояния политики.

PolicyStatesQueryResults

Объект

Результаты запроса.

Имя	Тип	Описание
@odata.context	string	Строка контекста OData; используется клиентами OData для разрешения сведений о типе на основе метаданных.
@odata.count	integer (int32) minimum: 0	Число сущностей OData; представляет количество возвращаемых записей состояния политики.
@odata.nextLink	string	Следующая ссылка odata; URL-адрес для получения следующего набора результатов.
value	PolicyState[]	Результаты запроса.

QueryFailure

Объект

Ответ на ошибку.

Имя	Тип	Описание
error	Error	Определение ошибки.