Policy Enrollments - List For Resource

Служба:: Policy

Версия API:: 2026-01-01-preview

Получает все регистрации полисов, которые применяются к ресурсу.
Эта операция получает список всех регистраций политик, связанных с указанным ресурсом в данной группе ресурсов и подписке, которые соответствуют необязательному данному $filter. Допустимые значения для $filter: 'atScope()' или 'atExactScope()'. Если $filter не предоставлено, неотфильтрованный список включает все регистрации политик, связанные с ресурсом, включая те, которые применяются напрямую или из всех содержащих областей, а также любые применяемые к ресурсам, содержащимся в ресурсе. Для идентификации определенного ресурса используются три параметра, а также имя ресурса. Если ресурс не является частью родительского ресурса (более распространенным случаем), родительский путь к ресурсу не должен быть указан (или указан как "). Например, веб-приложение можно указать как ({resourceProviderNamespace} == 'Microsoft.Web', {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp'). Если ресурс является частью родительского ресурса, необходимо предоставить все параметры. Например, DNS-имя виртуальной машины можно указать как ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName'). Удобная альтернатива предоставлению пространства имен и имени типа отдельно заключается в том, чтобы указать оба параметра {resourceType}, формат: ({resourceProviderNamespace} == ', {parentResourcePath} == '', {resourceType} == 'Microsoft.Web/sites', {resourceName} == 'MyWebApp').

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{parentResourcePath}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{parentResourcePath}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview&$filter={$filter}

Параметры URI

Имя	В	Обязательно	Тип	Описание
parentResourcePath	path	True	string	Родительский путь к ресурсу. Используйте пустую строку, если нет.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
resourceName	path	True	string pattern: ^.+$	Имя ресурса.
resourceProviderNamespace	path	True	string	Пространство имен поставщика ресурсов. Например, пространство имен виртуальной машины — Microsoft.Compute (из Microsoft.Compute/virtualMachines)
resourceType	path	True	string	Имя типа ресурса. Например, имя типа веб-приложения — "сайты" (из Microsoft.Web/sites).
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
$filter	query		string	Фильтр, применяемый к операции. Допустимые значения для $filter: 'atScope()' или 'atExactScope()'. Если $filter не предоставлено, фильтрация не выполняется. Если $filter не предоставлено, неотфильтрованный список включает все регистрации политик, связанных с областью применения, включая те, которые применяются напрямую или содержат область применения. Если предоставлен $filter=atScope(), возвращаемый список включает все регистрации политик, применимые к области области, то есть всё, что находится в неотфильтрованном списке, кроме тех, что применяются к подобластям, входящим в данную область видимости. Если предоставлен $filter=atExactScope(), вернутый список включает только все регистрации политик, применимые в данной области.

Ответы

Имя	Тип	Описание
200 OK	PolicyEnrollmentListResult	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

List policy enrollments for resource

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

HTTP

GET https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Compute/virtualMachines/MyTestVm/domainNames/MyTestComputer.cloudapp.net/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview

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

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

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
        "policyDefinitionReferenceIds": [
          "Limit_Skus"
        ],
        "policyAssignmentInstanceId": "00000000-0000-0000-0000-000000000000",
        "displayName": "Enroll demo cluster",
        "description": "Enroll demo cluster from limit sku",
        "metadata": {
          "reason": "Enrollment for a expensive VM demo"
        }
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "User",
        "createdAt": "2020-07-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-07-01T02:01:01.1075056Z"
      },
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Authorization/policyEnrollments/DemoExpensiveVMGroup",
      "type": "Microsoft.Authorization/policyEnrollments",
      "eTag": "00000000-0000-0000-0000-000000000000",
      "name": "DemoExpensiveVMGroup"
    },
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/LimitPorts",
        "policyAssignmentInstanceId": "00000000-0000-0000-0000-000000000000",
        "displayName": "Enroll jump box open ports",
        "description": "Enroll jump box open ports from limit ports policy",
        "metadata": {
          "reason": "Need to open RDP port to corp net"
        }
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "User",
        "createdAt": "2020-07-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-07-01T02:01:01.1075056Z"
      },
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Compute/virtualMachines/MyTestVm/providers/Microsoft.Authorization/policyEnrollments/jumpBoxEnrollment",
      "type": "Microsoft.Authorization/policyEnrollments",
      "eTag": "00000000-0000-0000-0000-000000000000",
      "name": "jumpBoxEnrollment"
    }
  ]
}

Определения

Имя	Описание
AssignmentScopeValidation	Возможность подтвердить, относится ли освобождение или регистрация в рамках или в рамках сферы передачи.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
PolicyEnrollment	Регистрация по полису.
PolicyEnrollmentListResult	Реакция операции списка PolicyEnrollment.
ResourceSelector	Селектор ресурсов для фильтрации политик по свойствам ресурсов.
Selector	Выражение селектора.
SelectorKind	Тип селектора.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AssignmentScopeValidation

Перечисление

Возможность подтвердить, относится ли освобождение или регистрация в рамках или в рамках сферы передачи.

Значение	Описание
Default	Этот параметр проверяет, находится ли исключение в области назначения или находится под ней.
DoNotValidate	Этот параметр будет обходить проверку области исключения в области назначения политики или в пределах области назначения политики.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

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

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.