Policy Exemptions - Create Or Update

Esta operação cria ou atualiza uma isenção de política com o âmbito e o nome especificados. As isenções de política aplicam-se a todos os recursos contidos no âmbito. Por exemplo, quando cria uma isenção de política no âmbito do grupo de recursos para uma atribuição de política no mesmo nível ou superior, a isenção isenta a todos os recursos aplicáveis no grupo de recursos.

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}?api-version=2022-07-01-preview

Parâmetros do URI

Name Em Necessário Tipo Description
policyExemptionName
path True

string

O nome da isenção de política a eliminar.

scope
path True

string

O âmbito da isenção de política. Os âmbitos válidos são: grupo de gestão (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), subscrição (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{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 utilizar para a operação.

Corpo do Pedido

Name Necessário Tipo Description
properties.exemptionCategory True

exemptionCategory

A categoria de isenção de política. Os valores possíveis são Renúncia e Mitigação.

properties.policyAssignmentId True

string

O ID da atribuição de política que está a ser isenta.

properties.assignmentScopeValidation

AssignmentScopeValidation

A opção quer valide a isenção está no âmbito da atribuição ou no âmbito da atribuição.

properties.description

string

A descrição da isenção de política.

properties.displayName

string

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

properties.expiresOn

string

A data e hora de expiração (no formato UTC ISO 8601 yyyy-MM-ddTHH:mm:ssZ) da isenção da política.

properties.metadata

object

Os metadados de isenção de política. Os metadados são um objeto com extremidade aberta e, normalmente, são uma coleção de pares de valores chave.

properties.policyDefinitionReferenceIds

string[]

A lista ID de referência da definição de política quando a atribuição de política associada é uma atribuição de uma definição de conjunto de políticas.

properties.resourceSelectors

ResourceSelector[]

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

Respostas

Name Tipo Description
200 OK

PolicyExemption

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

201 Created

PolicyExemption

Criado – devolve informações sobre a nova isenção de política.

Other Status Codes

CloudError

Resposta de erro que descreve a razão 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

Create or update a policy exemption
Create or update a policy exemption with resource selectors

Create or update a policy exemption

Sample Request

PUT https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM?api-version=2022-07-01-preview

{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption for a expensive VM demo"
    }
  }
}

Sample Response

{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption for a expensive VM demo"
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-07-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-07-01T01:01:01.1075056Z"
  },
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM",
  "type": "Microsoft.Authorization/policyExemptions",
  "name": "DemoExpensiveVM"
}
{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption 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/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM",
  "type": "Microsoft.Authorization/policyExemptions",
  "name": "DemoExpensiveVM"
}

Create or update a policy exemption with resource selectors

Sample Request

PUT https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM?api-version=2022-07-01-preview

{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption for a expensive VM demo"
    },
    "assignmentScopeValidation": "Default",
    "resourceSelectors": [
      {
        "name": "SDPRegions",
        "selectors": [
          {
            "kind": "resourceLocation",
            "in": [
              "eastus2euap",
              "centraluseuap"
            ]
          }
        ]
      }
    ]
  }
}

Sample Response

{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption for a expensive VM demo"
    },
    "assignmentScopeValidation": "Default",
    "resourceSelectors": [
      {
        "name": "SDPRegions",
        "selectors": [
          {
            "kind": "resourceLocation",
            "in": [
              "eastus2euap",
              "centraluseuap"
            ]
          }
        ]
      }
    ]
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-07-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-07-01T01:01:01.1075056Z"
  },
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM",
  "type": "Microsoft.Authorization/policyExemptions",
  "name": "DemoExpensiveVM"
}
{
  "properties": {
    "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
    "policyDefinitionReferenceIds": [
      "Limit_Skus"
    ],
    "exemptionCategory": "Waiver",
    "displayName": "Exempt demo cluster",
    "description": "Exempt demo cluster from limit sku",
    "metadata": {
      "reason": "Temporary exemption for a expensive VM demo"
    },
    "assignmentScopeValidation": "Default",
    "resourceSelectors": [
      {
        "name": "SDPRegions",
        "selectors": [
          {
            "kind": "resourceLocation",
            "in": [
              "eastus2euap",
              "centraluseuap"
            ]
          }
        ]
      }
    ]
  },
  "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/demoCluster/providers/Microsoft.Authorization/policyExemptions/DemoExpensiveVM",
  "type": "Microsoft.Authorization/policyExemptions",
  "name": "DemoExpensiveVM"
}

Definições

Name Description
AssignmentScopeValidation

A opção quer valide a isenção está no âmbito da atribuição ou no âmbito da atribuição.

CloudError

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

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

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

ErrorResponse

Resposta a Erros

exemptionCategory

A categoria de isenção de política. Os valores possíveis são Renúncia e Mitigação.

PolicyExemption

A isenção de política.

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.

AssignmentScopeValidation

A opção quer valide a isenção está no âmbito da atribuição ou no âmbito da atribuição.

Name Tipo Description
Default

string

Esta opção irá validar se a isenção está no âmbito da atribuição ou no âmbito da atribuição.

DoNotValidate

string

Esta opção irá ignorar a validação em que o âmbito de isenção está no âmbito da atribuição de políticas ou no âmbito da atribuição de políticas.

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 Resource Manager do Azure para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

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ção adicional.

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.

exemptionCategory

A categoria de isenção de política. Os valores possíveis são Renúncia e Mitigação.

Name Tipo Description
Mitigated

string

Normalmente, esta categoria de isenções significa que as ações de mitigação foram aplicadas ao âmbito.

Waiver

string

Normalmente, esta categoria de isenções significa que o âmbito não é aplicável à política.

PolicyExemption

A isenção de política.

Name Tipo Valor Predefinido Description
id

string

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

name

string

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

properties.assignmentScopeValidation

AssignmentScopeValidation

Default

A opção quer valide a isenção está no âmbito da atribuição ou no âmbito da atribuição.

properties.description

string

A descrição da isenção de política.

properties.displayName

string

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

properties.exemptionCategory

exemptionCategory

A categoria de isenção de política. Os valores possíveis são Renúncia e Mitigação.

properties.expiresOn

string

A data e hora de expiração (no formato UTC ISO 8601 yyyy-MM-ddTHH:mm:ssZ) da isenção da política.

properties.metadata

object

Os metadados de isenção de política. Os metadados são um objeto com extremidade aberta e, normalmente, são uma coleção de pares de valores chave.

properties.policyAssignmentId

string

O ID da atribuição de política que está a ser isenta.

properties.policyDefinitionReferenceIds

string[]

A lista ID de referência da definição de política quando a atribuição de política associada é uma atribuição de uma definição de conjunto de políticas.

properties.resourceSelectors

ResourceSelector[]

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

systemData

systemData

O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.

type

string

O tipo de recurso (Microsoft.Authorization/policyExemptions).

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 seletor tipo 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 seletor tipo 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.