Policy Enrollments - List For Resource

サービス:: Policy

API バージョン:: 2026-01-01-preview

リソースに適用されるすべてのポリシー登録を取得します。
この操作は、指定されたリソースグループおよびサブスクリプションで、任意の$filterに一致するすべてのポリシー登録のリストを取得します。有効な$filter値は「atScope()」または「atExactScope()」です。もし提供されていない$filter、フィルターなしのリストにはリソースに関連付けられたすべてのポリシー登録(直接適用されるもの、または含まれるすべてのスコープからのものを含む)、さらにリソース内に含まれたリソースに適用されるものが含まれます。特定のリソースを識別するには、3 つのパラメーターとリソース名が使用されます。リソースが親リソースの一部でない場合 (より一般的なケース)、親リソースパスを指定 (または '' として指定) しないでください。たとえば、Web アプリは ({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	リソースの種類の名前。たとえば、Web アプリの型名は "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()が提供されている場合、返されるリストには指定された範囲で適用されるすべてのポリシー登録のみが含まれます。

応答

名前	型	説明
200 OK	PolicyEnrollmentListResult	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
PolicyEnrollment	保険加入について。
PolicyEnrollmentListResult	PolicyEnrollmentリスト操作の応答。
ResourceSelector	リソースプロパティでポリシーをフィルター処理するリソースセレクター。
Selector	セレクター式。
SelectorKind	セレクターの種類。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AssignmentScopeValidation

列挙

免除や登録が割り当て範囲内か、またはその範囲内かを検証するオプション。

値	説明
Default	このオプションを選択すると、割り当てスコープ内または割り当てスコープの下で除外が検証されます。
DoNotValidate	このオプションは、除外スコープがポリシー割り当てスコープにあるか、またはポリシー割り当てスコープの下にある検証をバイパスします。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。