Policy Assignments - Delete

Referência

Serviço:: Policy

Versão da API:: 2023-04-01

Esta operação exclui uma atribuição de política, dado seu nome e o escopo em que foi criada. O escopo de uma atribuição de política é a parte de sua ID que precede '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

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

Parâmetros do URI

Name Em Necessário Tipo Description

Name	Em	Necessário	Tipo	Description
policyAssignmentName	path	True	string	O nome da atribuição de política a ser excluída. Padrão Regex: `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$`
scope	path	True	string	O escopo da atribuição de política. Os escopos válidos são: grupo de gerenciamento (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
api-version	query	True	string	A versão da API a ser usada para esta operação.

policyAssignmentName

path

True

string

O nome da atribuição de política a ser excluída.

Padrão Regex: ^[^<>*%&:\?.+/]*[^<>*%&:\?.+/ ]+$

scope

path

True

string

O escopo da atribuição de política. Os escopos válidos são: grupo de gerenciamento (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version

query

True

string

A versão da API a ser usada para esta operação.

Respostas

Name	Tipo	Description
200 OK	PolicyAssignment	OK - Retorna informações sobre a atribuição excluída.
204 No Content		Sem conteúdo - a atribuição de política não existe.
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Delete a policy assignment

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 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"
}

Código de estado:: 204

Definições

Name	Description
CloudError	Uma resposta de erro de uma operação de política.
createdByType	O tipo de identidade que criou o recurso.
enforcementMode	O modo de imposição de atribuição de política. Os valores possíveis são Default e DoNotEnforce.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorResponse	Resposta de erro
Identity	Identidade do recurso. As atribuições de política suportam um máximo de uma identidade. Essa é uma identidade atribuída ao sistema ou uma identidade atribuída a um único usuário.
NonComplianceMessage	Uma mensagem que descreve por que um recurso não está em conformidade com a política. Isso é mostrado em mensagens de erro "negar" e nos resultados de conformidade não compatíveis do recurso.
Override	A substituição do valor da propriedade da política.
OverrideKind	O tipo de substituição.
ParameterValuesValue	O valor de um parâmetro.
PolicyAssignment	A atribuição de política.
ResourceIdentityType	O tipo de identidade. Este é o único campo obrigatório ao adicionar uma identidade atribuída ao sistema ou usuário a um recurso.
ResourceSelector	O seletor de recursos para filtrar políticas por propriedades de recursos.
Selector	A expressão do seletor.
SelectorKind	O tipo seletor.
systemData	Metadados referentes à criação e última modificação do recurso.
UserAssignedIdentities	A identidade do usuário associada à política. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

CloudError

Uma resposta de erro de uma operação de política.

Name	Tipo	Description
error	ErrorResponse	Resposta de erro Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

enforcementMode

O modo de imposição de atribuição de política. Os valores possíveis são Default e DoNotEnforce.

Name	Tipo	Description
Default	string	O efeito da política é imposto durante a criação ou atualização de recursos.
DoNotEnforce	string	O efeito da política não é imposto durante a criação ou atualização de recursos.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorResponse

Resposta de erro

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorResponse[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

Identity

Identidade do recurso. As atribuições de política suportam um máximo de uma identidade. Essa é uma identidade atribuída ao sistema ou uma identidade atribuída a um único usuário.

Name	Tipo	Description
principalId	string	A ID principal da identidade do recurso. Esta propriedade só será fornecida para uma identidade atribuída ao sistema
tenantId	string	A ID do locatário da identidade do recurso. Esta propriedade só será fornecida para uma identidade atribuída ao sistema
type	ResourceIdentityType	O tipo de identidade. Este é o único campo obrigatório ao adicionar uma identidade atribuída ao sistema ou usuário a um recurso.
userAssignedIdentities	UserAssignedIdentities	A identidade do usuário associada à política. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

NonComplianceMessage

Uma mensagem que descreve por que um recurso não está em conformidade com a política. Isso é mostrado em mensagens de erro "negar" e nos resultados de conformidade não compatíveis do recurso.

Name	Tipo	Description
message	string	Uma mensagem que descreve por que um recurso não está em conformidade com a política. Isso é mostrado em mensagens de erro "negar" e nos resultados de conformidade não compatíveis do recurso.
policyDefinitionReferenceId	string	O ID de referência de definição de política dentro de uma definição de conjunto de políticas a que a mensagem se destina. Isso só é aplicável se a atribuição de política atribuir uma definição de conjunto de políticas. Se isso não for fornecido, a mensagem se aplicará a todas as políticas atribuídas por essa atribuição de política.

Override

A substituição do valor da propriedade da política.

Name	Tipo	Description
kind	OverrideKind	O tipo de substituição.
selectors	Selector[]	A lista das expressões do seletor.
value	string	O valor para substituir a propriedade policy.

OverrideKind

O tipo de substituição.

Name	Tipo	Description
policyEffect	string	Ele substituirá o tipo de efeito de política.

ParameterValuesValue

O valor de um parâmetro.

Name	Tipo	Description
value	object	O valor do parâmetro.