Policy Exemptions - Create Or Update
Эта операция создает или обновляет исключение политики с заданной областью и именем. Исключения политики применяются ко всем ресурсам, содержащимся в их области. Например, при создании исключения политики в области группы ресурсов для назначения политики на том же или более высоком уровне исключение освобождает все применимые ресурсы в группе ресурсов.
PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}?api-version=2022-07-01-preview
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
policy
|
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 |
Категория исключения политики. Возможные значения: отказ и устранение рисков. |
|
properties.policyAssignmentId | True |
string |
Идентификатор назначения политики, который освобождается. |
properties.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 |
Список селекторов ресурсов для фильтрации политик по свойствам ресурсов. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК. Возвращает сведения об обновленном исключении политики. |
|
201 Created |
Создано — возвращает сведения о исключении новой политики. |
|
Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
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"
}
Определения
Имя | Описание |
---|---|
Assignment |
Параметр, проверяя, находится ли исключение в области назначения или находится под ней. |
Cloud |
Ответ на ошибку из операции политики. |
created |
Тип удостоверения, создавшего ресурс. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Ответ на ошибку |
exemption |
Категория исключения политики. Возможные значения: отказ и устранение рисков. |
Policy |
Исключение политики. |
Resource |
Селектор ресурсов для фильтрации политик по свойствам ресурсов. |
Selector |
Выражение селектора. |
Selector |
Тип селектора. |
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
AssignmentScopeValidation
Параметр, проверяя, находится ли исключение в области назначения или находится под ней.
Значение | Описание |
---|---|
Default |
Этот параметр проверяет, находится ли исключение в области назначения или находится под ней. |
DoNotValidate |
Этот параметр будет обходить проверку области исключения в области назначения политики или в пределах области назначения политики. |
CloudError
Ответ на ошибку из операции политики.
Имя | Тип | Описание |
---|---|---|
error |
Ответ на ошибку |
createdByType
Тип удостоверения, создавшего ресурс.
Значение | Описание |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
ErrorResponse
Ответ на ошибку
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
exemptionCategory
Категория исключения политики. Возможные значения: отказ и устранение рисков.
Значение | Описание |
---|---|
Mitigated |
Эта категория исключений обычно означает, что действия по устранению рисков были применены к области. |
Waiver |
Эта категория исключений обычно означает, что область не применима к политике. |
PolicyExemption
Исключение политики.
Имя | Тип | Default value | Описание |
---|---|---|---|
id |
string |
Идентификатор исключения политики. |
|
name |
string |
Имя исключения политики. |
|
properties.assignmentScopeValidation | Default |
Параметр, проверяя, находится ли исключение в области назначения или находится под ней. |
|
properties.description |
string |
Описание исключения политики. |
|
properties.displayName |
string |
Отображаемое имя исключения политики. |
|
properties.exemptionCategory |
Категория исключения политики. Возможные значения: отказ и устранение рисков. |
||
properties.expiresOn |
string (date-time) |
Дата и время окончания срока действия (в формате UTC ISO 8601 формат гггг-ММ-ддTHH:mm:ssZ) исключения политики. |
|
properties.metadata |
object |
Метаданные исключения политики. Метаданные — это открытый завершенный объект, который обычно представляет собой коллекцию пар значений ключей. |
|
properties.policyAssignmentId |
string |
Идентификатор назначения политики, который освобождается. |
|
properties.policyDefinitionReferenceIds |
string[] |
Список ссылок на определение политики при назначении связанной политики является назначением определения набора политик. |
|
properties.resourceSelectors |
Список селекторов ресурсов для фильтрации политик по свойствам ресурсов. |
||
systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
||
type |
string |
Тип ресурса (Microsoft.Authorization/policyExemptions). |
ResourceSelector
Селектор ресурсов для фильтрации политик по свойствам ресурсов.
Имя | Тип | Описание |
---|---|---|
name |
string |
Имя селектора ресурсов. |
selectors |
Selector[] |
Список выражений селектора. |
Selector
Выражение селектора.
Имя | Тип | Описание |
---|---|---|
in |
string[] |
Список значений для фильтрации. |
kind |
Тип селектора. |
|
notIn |
string[] |
Список значений для фильтрации. |
SelectorKind
Тип селектора.
Значение | Описание |
---|---|
policyDefinitionReferenceId |
Тип селектора для фильтрации политик по идентификатору ссылки на определение политики. |
resourceLocation |
Тип селектора для фильтрации политик по расположению ресурса. |
resourceType |
Тип селектора для фильтрации политик по типу ресурса. |
resourceWithoutLocation |
Тип селектора для фильтрации политик по ресурсу без расположения. |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |