Поделиться через


Policy Exemptions - Create Or Update

Эта операция создает или обновляет исключение политики с заданной областью и именем. Исключения политики применяются ко всем ресурсам, содержащимся в их области. Например, при создании исключения политики в области группы ресурсов для назначения политики на том же или более высоком уровне исключение освобождает все применимые ресурсы в группе ресурсов.

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

Параметры URI

Имя В Обязательно Тип Описание
policyExemptionName
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, используемая для операции.

Текст запроса

Имя Обязательно Тип Описание
properties.exemptionCategory True

exemptionCategory

Категория исключения политики. Возможные значения: отказ и устранение рисков.

properties.policyAssignmentId True

string

Идентификатор назначения политики, который освобождается.

properties.assignmentScopeValidation

AssignmentScopeValidation

Параметр, проверяя, находится ли исключение в области назначения или находится под ней.

properties.description

string

Описание исключения политики.

properties.displayName

string

Отображаемое имя исключения политики.

properties.expiresOn

string (date-time)

Дата и время окончания срока действия (в формате UTC ISO 8601 формат гггг-ММ-ддTHH:mm:ssZ) исключения политики.

properties.metadata

object

Метаданные исключения политики. Метаданные — это открытый завершенный объект, который обычно представляет собой коллекцию пар значений ключей.

properties.policyDefinitionReferenceIds

string[]

Список ссылок на определение политики при назначении связанной политики является назначением определения набора политик.

properties.resourceSelectors

ResourceSelector[]

Список селекторов ресурсов для фильтрации политик по свойствам ресурсов.

Ответы

Имя Тип Описание
200 OK

PolicyExemption

ОК. Возвращает сведения об обновленном исключении политики.

201 Created

PolicyExemption

Создано — возвращает сведения о исключении новой политики.

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

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

Create or update a policy exemption

Образец запроса

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

Пример ответа

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

Образец запроса

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"
            ]
          }
        ]
      }
    ]
  }
}

Пример ответа

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

Определения

Имя Описание
AssignmentScopeValidation

Параметр, проверяя, находится ли исключение в области назначения или находится под ней.

CloudError

Ответ на ошибку из операции политики.

createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorResponse

Ответ на ошибку

exemptionCategory

Категория исключения политики. Возможные значения: отказ и устранение рисков.

PolicyExemption

Исключение политики.

ResourceSelector

Селектор ресурсов для фильтрации политик по свойствам ресурсов.

Selector

Выражение селектора.

SelectorKind

Тип селектора.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

AssignmentScopeValidation

Параметр, проверяя, находится ли исключение в области назначения или находится под ней.

Значение Описание
Default

Этот параметр проверяет, находится ли исключение в области назначения или находится под ней.

DoNotValidate

Этот параметр будет обходить проверку области исключения в области назначения политики или в пределах области назначения политики.

CloudError

Ответ на ошибку из операции политики.

Имя Тип Описание
error

ErrorResponse

Ответ на ошибку
Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа на ошибку OData.)

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorResponse[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

exemptionCategory

Категория исключения политики. Возможные значения: отказ и устранение рисков.

Значение Описание
Mitigated

Эта категория исключений обычно означает, что действия по устранению рисков были применены к области.

Waiver

Эта категория исключений обычно означает, что область не применима к политике.

PolicyExemption

Исключение политики.

Имя Тип Default value Описание
id

string

Идентификатор исключения политики.

name

string

Имя исключения политики.

properties.assignmentScopeValidation

AssignmentScopeValidation

Default

Параметр, проверяя, находится ли исключение в области назначения или находится под ней.

properties.description

string

Описание исключения политики.

properties.displayName

string

Отображаемое имя исключения политики.

properties.exemptionCategory

exemptionCategory

Категория исключения политики. Возможные значения: отказ и устранение рисков.

properties.expiresOn

string (date-time)

Дата и время окончания срока действия (в формате UTC ISO 8601 формат гггг-ММ-ддTHH:mm:ssZ) исключения политики.

properties.metadata

object

Метаданные исключения политики. Метаданные — это открытый завершенный объект, который обычно представляет собой коллекцию пар значений ключей.

properties.policyAssignmentId

string

Идентификатор назначения политики, который освобождается.

properties.policyDefinitionReferenceIds

string[]

Список ссылок на определение политики при назначении связанной политики является назначением определения набора политик.

properties.resourceSelectors

ResourceSelector[]

Список селекторов ресурсов для фильтрации политик по свойствам ресурсов.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

type

string

Тип ресурса (Microsoft.Authorization/policyExemptions).

ResourceSelector

Селектор ресурсов для фильтрации политик по свойствам ресурсов.

Имя Тип Описание
name

string

Имя селектора ресурсов.

selectors

Selector[]

Список выражений селектора.

Selector

Выражение селектора.

Имя Тип Описание
in

string[]

Список значений для фильтрации.

kind

SelectorKind

Тип селектора.

notIn

string[]

Список значений для фильтрации.

SelectorKind

Тип селектора.

Значение Описание
policyDefinitionReferenceId

Тип селектора для фильтрации политик по идентификатору ссылки на определение политики.

resourceLocation

Тип селектора для фильтрации политик по расположению ресурса.

resourceType

Тип селектора для фильтрации политик по типу ресурса.

resourceWithoutLocation

Тип селектора для фильтрации политик по ресурсу без расположения.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.