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 매개 변수

Name	In(다음 안에)	필수	형식	Description
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	리소스 종류 이름입니다. 예를 들어 웹앱의 형식 이름은 'sites'(Microsoft.Web/sites)입니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$filter	query		string	작업에 적용할 필터입니다. 유효한 $filter값은 'atScope()' 또는 'atExactScope()'입니다. $filter 제공되지 않으면 필터링이 수행되지 않습니다. $filter이 제공되지 않을 경우, 필터링되지 않은 목록에는 범위와 관련된 모든 정책 등록이 포함되며, 직접 적용되거나 범위를 포함하는 것까지 포함됩니다. $filter=atScope()가 제공되면, 반환된 목록에는 해당 범위에 적용되는 모든 정책 등록이 포함되며, 이는 필터링되지 않은 목록에 있는 하위 범위에 적용된 모든 것을 포함합니다. 만약 $filter=atExactScope()가 제공되면, 반환된 목록에는 해당 범위에 적용되는 모든 정책 등록만 포함됩니다.

응답

Name	형식	Description
200 OK	PolicyEnrollmentListResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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"
    }
  ]
}

정의

Name	Description
AssignmentScopeValidation	면제 또는 등록이 할당 범위에 속하는지 여부를 검증하는 옵션입니다.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
PolicyEnrollment	보험 가입 문제입니다.
PolicyEnrollmentListResult	PolicyEnrollment 리스트 작업의 대응.
ResourceSelector	리소스 속성을 사용하여 정책을 필터링할 리소스 선택기입니다.
Selector	선택기 식입니다.
SelectorKind	선택기 종류입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

AssignmentScopeValidation

열거형

면제 또는 등록이 할당 범위에 속하는지 여부를 검증하는 옵션입니다.

값	Description
Default	이 옵션은 예외가 할당 범위 또는 그 아래에 있는지 확인합니다.
DoNotValidate	이 옵션은 예외 범위가 정책 할당 범위 또는 아래에 있는 유효성 검사를 무시합니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.