Policy Assignments - Delete By Id
ポリシー割り当てを削除します。
この操作により、指定された ID を持つポリシーが削除されます。 ポリシー割り当て ID の形式は'{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' です。 {scope} の有効な形式: '/providers/Microsoft.Management/managementGroups/{managementGroup}' (管理グループ)、'/subscriptions/{subscriptionId}' (サブスクリプション)、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' (リソース グループ)、または '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' (resource)。
DELETE https://management.azure.com/{policyAssignmentId}?api-version=2023-04-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
policy
|
path | True |
string |
削除するポリシー割り当ての ID。 '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' の形式を使用します。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK - ポリシーの割り当てに関する情報を返します。 |
|
204 No Content |
コンテンツなし - ポリシーの割り当ては存在しません。 |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Delete a policy assignment by ID
要求のサンプル
DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage?api-version=2023-04-01
応答のサンプル
{
"properties": {
"displayName": "Enforce storage account SKU",
"description": "Allow only storage accounts of SKU Standard_GRS or Standard_LRS to be created",
"metadata": {
"assignedBy": "Cheapskate Boss"
},
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
"definitionVersion": "1.*.*",
"notScopes": [],
"parameters": {
"listOfAllowedSKUs": {
"value": [
"Standard_GRS",
"Standard_LRS"
]
}
}
},
"id": "/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage",
"type": "Microsoft.Authorization/policyAssignments",
"name": "LowCostStorage"
}
定義
名前 | 説明 |
---|---|
Cloud |
ポリシー操作からのエラー応答。 |
created |
リソースを作成した ID の種類。 |
enforcement |
ポリシー割り当て適用モード。 使用できる値は Default と DoNotEnforce です。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラー応答 |
Identity |
リソースの ID。 ポリシー割り当てでは、最大 1 つの ID がサポートされます。 これは、システム割り当て ID または単一ユーザー割り当て ID のいずれかです。 |
Non |
リソースがポリシーに準拠していない理由を説明するメッセージ。 これは、"拒否" エラー メッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。 |
Override |
ポリシー プロパティ値のオーバーライド。 |
Override |
オーバーライドの種類。 |
Parameter |
パラメーターの値。 |
Policy |
ポリシーの割り当て。 |
Resource |
ID の種類。 これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。 |
Resource |
リソース プロパティでポリシーをフィルター処理するリソース セレクター。 |
Selector |
セレクター式。 |
Selector |
セレクターの種類。 |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
User |
ポリシーに関連付けられているユーザー ID。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。 |
CloudError
ポリシー操作からのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラー応答 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
enforcementMode
ポリシー割り当て適用モード。 使用できる値は Default と DoNotEnforce です。
名前 | 型 | 説明 |
---|---|---|
Default |
string |
ポリシー効果は、リソースの作成または更新中に適用されます。 |
DoNotEnforce |
string |
ポリシー効果は、リソースの作成時または更新中には適用されません。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーターゲット。 |
Identity
リソースの ID。 ポリシー割り当てでは、最大 1 つの ID がサポートされます。 これは、システム割り当て ID または単一ユーザー割り当て ID のいずれかです。
名前 | 型 | 説明 |
---|---|---|
principalId |
string |
リソース ID のプリンシパル ID。 このプロパティは、システム割り当て ID に対してのみ提供されます |
tenantId |
string |
リソース ID のテナント ID。 このプロパティは、システム割り当て ID に対してのみ提供されます |
type |
ID の種類。 これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。 |
|
userAssignedIdentities |
ポリシーに関連付けられているユーザー ID。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。 |
NonComplianceMessage
リソースがポリシーに準拠していない理由を説明するメッセージ。 これは、"拒否" エラー メッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。
名前 | 型 | 説明 |
---|---|---|
message |
string |
リソースがポリシーに準拠していない理由を説明するメッセージ。 これは、"拒否" エラー メッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。 |
policyDefinitionReferenceId |
string |
メッセージの対象となるポリシー セット定義内のポリシー定義参照 ID。 これは、ポリシー割り当てによってポリシー セット定義が割り当てられている場合にのみ適用されます。 これが指定されていない場合、メッセージは、このポリシー割り当てによって割り当てられたすべてのポリシーに適用されます。 |
Override
ポリシー プロパティ値のオーバーライド。
名前 | 型 | 説明 |
---|---|---|
kind |
オーバーライドの種類。 |
|
selectors |
Selector[] |
セレクター式の一覧。 |
value |
string |
ポリシー プロパティをオーバーライドする値。 |
OverrideKind
オーバーライドの種類。
名前 | 型 | 説明 |
---|---|---|
policyEffect |
string |
ポリシー効果の種類がオーバーライドされます。 |
ParameterValuesValue
パラメーターの値。
名前 | 型 | 説明 |
---|---|---|
value |
object |
パラメーターの値。 |
PolicyAssignment
ポリシーの割り当て。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
id |
string |
ポリシー割り当ての ID。 |
|
identity |
ポリシーの割り当てに関連付けられているマネージド ID。 |
||
location |
string |
ポリシー割り当ての場所。 マネージド ID を使用する場合にのみ必要です。 |
|
name |
string |
ポリシー割り当ての名前。 |
|
properties.definitionVersion |
string |
使用するポリシー定義のバージョン。 |
|
properties.description |
string |
このメッセージは、ポリシー違反が発生した場合の応答の一部になります。 |
|
properties.displayName |
string |
ポリシー割り当ての表示名。 |
|
properties.effectiveDefinitionVersion |
string |
使用中のポリシー定義の有効なバージョン。 これは、$expand クエリ パラメーターを使用して要求された場合にのみ存在します。 |
|
properties.enforcementMode | Default |
ポリシー割り当て適用モード。 使用できる値は Default と DoNotEnforce です。 |
|
properties.latestDefinitionVersion |
string |
使用可能なポリシー定義の最新バージョン。 これは、$expand クエリ パラメーターを使用して要求された場合にのみ存在します。 |
|
properties.metadata |
object |
ポリシー割り当てのメタデータ。 メタデータはオープン エンド オブジェクトであり、通常はキーと値のペアのコレクションです。 |
|
properties.nonComplianceMessages |
リソースがポリシーに準拠していない理由を説明するメッセージ。 |
||
properties.notScopes |
string[] |
ポリシーの除外されたスコープ。 |
|
properties.overrides |
Override[] |
ポリシー プロパティ値のオーバーライド。 |
|
properties.parameters |
<string,
Parameter |
割り当てられたポリシー ルールのパラメーター値。 キーはパラメーター名です。 |
|
properties.policyDefinitionId |
string |
割り当てられているポリシー定義またはポリシー セット定義の ID。 |
|
properties.resourceSelectors |
リソース のプロパティでポリシーをフィルター処理するリソース セレクターの一覧。 |
||
properties.scope |
string |
ポリシー割り当てのスコープ。 |
|
systemData |
このリソースに関連するシステム メタデータ。 |
||
type |
string |
ポリシー割り当ての種類。 |
ResourceIdentityType
ID の種類。 これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。
名前 | 型 | 説明 |
---|---|---|
None |
string |
リソースに関連付けられている ID が存在しないか、既存の ID を削除する必要があることを示します。 |
SystemAssigned |
string |
システム割り当て ID がリソースに関連付けられていることを示します。 |
UserAssigned |
string |
システム割り当て ID がリソースに関連付けられていることを示します。 |
ResourceSelector
リソース プロパティでポリシーをフィルター処理するリソース セレクター。
名前 | 型 | 説明 |
---|---|---|
name |
string |
リソース セレクターの名前。 |
selectors |
Selector[] |
セレクター式の一覧。 |
Selector
セレクター式。
名前 | 型 | 説明 |
---|---|---|
in |
string[] |
フィルター処理する値の一覧。 |
kind |
セレクターの種類。 |
|
notIn |
string[] |
フィルター処理する値の一覧。 |
SelectorKind
セレクターの種類。
名前 | 型 | 説明 |
---|---|---|
policyDefinitionReferenceId |
string |
ポリシー定義参照 ID でポリシーをフィルター処理するセレクターの種類。 |
resourceLocation |
string |
リソースの場所によってポリシーをフィルター処理するセレクターの種類。 |
resourceType |
string |
リソースの種類でポリシーをフィルター処理するセレクターの種類。 |
resourceWithoutLocation |
string |
場所のないリソースによってポリシーをフィルター処理するセレクターの種類。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |
UserAssignedIdentities
ポリシーに関連付けられているユーザー ID。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。
名前 | 型 | 説明 |
---|---|---|
|