Policy Assignments - Delete By Id

Elimina uma atribuição de política.
Esta operação elimina a política com o ID especificado. Os IDs de atribuição de políticas têm este formato: "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}". Os formatos válidos para {scope} são: "/providers/Microsoft.Management/managementGroups/{managementGroup}" (grupo de gestão), "/subscriptions/{subscriptionId}" (subscrição), "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}" " (grupo de recursos) ou "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}" (recurso).

DELETE https://management.azure.com/{policyAssignmentId}?api-version=2023-04-01

Parâmetros do URI

Name Em Necessário Tipo Description
policyAssignmentId
path True

string

O ID da atribuição de política a eliminar. Utilize o formato "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

api-version
query True

string

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

Respostas

Name Tipo Description
200 OK

PolicyAssignment

OK - Devolve informações sobre a atribuição de política.

204 No Content

Sem Conteúdo – a atribuição de política não existe.

Other Status Codes

CloudError

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Delete a policy assignment by ID

Sample Request

DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage?api-version=2023-04-01

Sample Response

{
  "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",
    "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"
}

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

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

Identity

Identidade do recurso. As atribuições de política suportam um máximo de uma identidade. Trata-se de uma identidade atribuída pelo sistema ou de uma única identidade atribuída pelo utilizador.

NonComplianceMessage

Uma mensagem que descreve o motivo pelo qual um recurso não está em conformidade com a política. Isto é mostrado nas mensagens de erro "negar" e nos resultados de conformidade não conformes 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 necessário ao adicionar um sistema ou identidade atribuída pelo utilizador 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 de seletor.

systemData

Metadados relativos à criação e última modificação do recurso.

UserAssignedIdentities

A identidade de utilizador associada à política. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/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 a Erros
Resposta de erro comum para todas as APIs do Azure Resource Manager para devolver detalhes do erro para operações com falhas. (Isto 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 de política não é imposto durante a criação ou atualização de recursos.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

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. Trata-se de uma identidade atribuída pelo sistema ou de uma única identidade atribuída pelo utilizador.

Name Tipo Description
principalId

string

O ID principal da identidade do recurso. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema

tenantId

string

O ID de inquilino da identidade do recurso. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema

type

ResourceIdentityType

O tipo de identidade. Este é o único campo necessário ao adicionar um sistema ou identidade atribuída pelo utilizador a um recurso.

userAssignedIdentities

UserAssignedIdentities

A identidade de utilizador associada à política. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

NonComplianceMessage

Uma mensagem que descreve o motivo pelo qual um recurso não está em conformidade com a política. Isto é mostrado nas mensagens de erro "negar" e nos resultados de conformidade não conformes do recurso.

Name Tipo Description
message

string

Uma mensagem que descreve o motivo pelo qual um recurso não está em conformidade com a política. Isto é mostrado nas mensagens de erro "negar" e nos resultados de conformidade não conformes do recurso.

policyDefinitionReferenceId

string

O ID de referência da definição de política numa definição de conjunto de políticas para a qual a mensagem se destina. Isto só é aplicável se a atribuição de política atribuir uma definição de conjunto de políticas. Se não for fornecida, a mensagem aplica-se a todas as políticas atribuídas por esta 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 a substituir a propriedade de política.

OverrideKind

O tipo de substituição.

Name Tipo Description
policyEffect

string

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 .

PolicyAssignment

A atribuição de política.

Name Tipo Valor Predefinido Description
id

string

O ID da atribuição de política.

identity

Identity

A identidade gerida associada à atribuição de política.

location

string

A localização da atribuição de política. Só é necessário ao utilizar a identidade gerida.

name

string

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

properties.description

string

Esta mensagem fará parte da resposta em caso de violação de política.

properties.displayName

string

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

properties.enforcementMode

enforcementMode

Default

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

properties.metadata

object

Os metadados de atribuição de política. Os metadados são um objeto final aberto e, normalmente, são uma coleção de pares de valores chave.

properties.nonComplianceMessages

NonComplianceMessage[]

As mensagens que descrevem o motivo pelo qual um recurso não está em conformidade com a política.

properties.notScopes

string[]

Os âmbitos excluídos da política.

properties.overrides

Override[]

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

properties.parameters

<string,  ParameterValuesValue>

Os valores dos parâmetros da regra de política atribuída. As chaves são os nomes dos parâmetros.

properties.policyDefinitionId

string

O ID da definição de política ou definição do conjunto de políticas que está a ser atribuída.

properties.resourceSelectors

ResourceSelector[]

A lista de seletores de recursos para filtrar políticas por propriedades de recursos.

properties.scope

string

O âmbito da atribuição de política.

systemData

systemData

Os metadados do sistema relacionados com este recurso.

type

string

O tipo de atribuição de política.

ResourceIdentityType

O tipo de identidade. Este é o único campo necessário ao adicionar um sistema ou identidade atribuída pelo utilizador a um recurso.

Name Tipo Description
None

string

Indica que nenhuma identidade está associada ao recurso ou que a identidade existente deve ser removida.

SystemAssigned

string

Indica que uma identidade atribuída pelo sistema está associada ao recurso.

UserAssigned

string

Indica que uma identidade atribuída pelo sistema está associada ao recurso.

ResourceSelector

O seletor de recursos para filtrar políticas por propriedades de recursos.

Name Tipo Description
name

string

O nome do seletor de recursos.

selectors

Selector[]

A lista das expressões do seletor.

Selector

A expressão do seletor.

Name Tipo Description
in

string[]

A lista de valores a filtrar.

kind

SelectorKind

O tipo de seletor.

notIn

string[]

A lista de valores a filtrar.

SelectorKind

O tipo de seletor.

Name Tipo Description
policyDefinitionReferenceId

string

O tipo de seletor para filtrar políticas pelo ID de referência da definição de política.

resourceLocation

string

O tipo de seletor para filtrar políticas pela localização do recurso.

resourceType

string

O tipo de seletor para filtrar políticas pelo tipo de recurso.

resourceWithoutLocation

string

O tipo de seletor para filtrar políticas pelo recurso sem localização.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

UserAssignedIdentities

A identidade de utilizador associada à política. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Tipo Description