你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Policy Assignments - Delete

参考

服务:: Policy

API 版本:: 2023-04-01

此操作会删除策略分配，给定其名称和创建范围。策略分配的范围是其 ID 前面的“/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}”的一部分。

DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}?api-version=2023-04-01

URI 参数

名称在必需类型说明

名称	在	必需	类型	说明
policyAssignmentName	path	True	string	要删除的策略分配的名称。正则表达式模式: `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$`
scope	path	True	string	策略分配的范围。有效范围包括：管理组（格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}'）、订阅（格式：'/subscriptions/{subscriptionId}'）、资源组（格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'，或资源（格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
api-version	query	True	string	用于此操作的 API 版本。

policyAssignmentName

path

True

string

要删除的策略分配的名称。

正则表达式模式: ^[^<>*%&:\?.+/]*[^<>*%&:\?.+/ ]+$

scope

path

True

string

策略分配的范围。有效范围包括：管理组（格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}'）、订阅（格式：'/subscriptions/{subscriptionId}'）、资源组（格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'，或资源（格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version

query

True

string

用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	PolicyAssignment	确定 - 返回有关已删除分配的信息。
204 No Content		无内容 - 策略分配不存在。
Other Status Codes	CloudError	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Delete a policy assignment

示例请求

HTTP

DELETE https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming?api-version=2023-04-01

示例响应

状态代码:: 200

{
  "properties": {
    "displayName": "Enforce resource naming rules",
    "description": "Force resource names to begin with given DeptA and end with -LC",
    "metadata": {
      "assignedBy": "Special Someone"
    },
    "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
    "definitionVersion": "1.*.*",
    "notScopes": [],
    "parameters": {
      "prefix": {
        "value": "DeptA"
      },
      "suffix": {
        "value": "-LC"
      }
    },
    "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2"
  },
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "EnforceNaming"
}

状态代码:: 204

定义

名称	说明
CloudError	策略操作的错误响应。
createdByType	创建资源的标识的类型。
enforcementMode	策略分配强制模式。可能的值为 Default 和 DoNotEnforce。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorResponse	错误响应
Identity	资源的标识。策略分配最多支持一个标识。这是系统分配的标识或单个用户分配的标识。
NonComplianceMessage	描述资源不符合策略的原因的消息。这会显示在“拒绝”错误消息中，以及资源的不符合符合性结果。
Override	策略属性值重写。
OverrideKind	重写类型。
ParameterValuesValue	参数的值。
PolicyAssignment	策略分配。
ResourceIdentityType	标识类型。这是将系统或用户分配的标识添加到资源时的唯一必填字段。
ResourceSelector	按资源属性筛选策略的资源选择器。
Selector	选择器表达式。
SelectorKind	选择器类型。
systemData	与创建和上次修改资源相关的元数据。
UserAssignedIdentities	与策略关联的用户标识。用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

CloudError

策略操作的错误响应。

名称	类型	说明
error	ErrorResponse	错误响应所有 Azure 资源管理器 API 的常见错误响应，以返回失败操作的错误详细信息。（这也遵循 OData 错误响应格式。）

createdByType

创建资源的标识的类型。

名称	类型	说明
Application	string
Key	string
ManagedIdentity	string
User	string

enforcementMode

策略分配强制模式。可能的值为 Default 和 DoNotEnforce。

名称	类型	说明
Default	string	在资源创建或更新期间强制实施策略效果。
DoNotEnforce	string	在资源创建或更新期间，不会强制实施策略效果。

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorResponse

错误响应

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorResponse[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

Identity

资源的标识。策略分配最多支持一个标识。这是系统分配的标识或单个用户分配的标识。

名称	类型	说明
principalId	string	资源标识的主体 ID。此属性仅针对系统分配的标识提供
tenantId	string	资源标识的租户 ID。此属性仅针对系统分配的标识提供
type	ResourceIdentityType	标识类型。这是将系统或用户分配的标识添加到资源时的唯一必填字段。
userAssignedIdentities	UserAssignedIdentities	与策略关联的用户标识。用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

NonComplianceMessage

描述资源不符合策略的原因的消息。这会显示在“拒绝”错误消息中，以及资源的不符合符合性结果。

名称	类型	说明
message	string	描述资源不符合策略的原因的消息。这会显示在“拒绝”错误消息中，以及资源的不符合符合性结果。
policyDefinitionReferenceId	string	消息适用于的策略集定义中的策略定义引用 ID。这仅适用于策略分配分配策略集定义。如果未提供此消息，则消息适用于此策略分配分配的所有策略。

Override

策略属性值重写。

名称	类型	说明
kind	OverrideKind	重写类型。
selectors	Selector[]	选择器表达式的列表。
value	string	要重写策略属性的值。

OverrideKind

重写类型。

名称	类型	说明
policyEffect	string	它将替代策略效果类型。

ParameterValuesValue

参数的值。

名称	类型	说明
value	object	参数的值。