Megosztás a következőn keresztül:


Policy Exemptions - Create Or Update

Ez a művelet létrehoz vagy frissít egy szabályzati kivételt a megadott hatókörrel és névvel. A szabályzatok kivételei a hatókörükbe tartozó összes erőforrásra vonatkoznak. Ha például egy szabályzat-hozzárendelés erőforráscsoport-hatókörében létrehoz egy szabályzatkivételt ugyanazon vagy magasabb szinten, a kivétel kivételt képez az erőforráscsoport összes alkalmazható erőforrása alól.

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

URI-paraméterek

Name In Kötelező Típus Description
policyExemptionName
path True

string

A törölni kívánt szabályzatmentesség neve.

scope
path True

string

A szabályzatmentesség hatóköre. Érvényes hatókörök: felügyeleti csoport (formátum: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), előfizetés (formátum: "/subscriptions/{subscriptionId}"), erőforráscsoport (formátum: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}", vagy erőforrás (formátum: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}"

api-version
query True

string

A művelethez használandó API-verzió.

Kérelem törzse

Name Kötelező Típus Description
properties.exemptionCategory True

exemptionCategory

A szabályzatmentességi kategória. Lehetséges értékek: Lemondás és Enyhítve.

properties.policyAssignmentId True

string

A mentesített szabályzat-hozzárendelés azonosítója.

properties.assignmentScopeValidation

AssignmentScopeValidation

Az a lehetőség, hogy a kivétel ellenőrzése a hozzárendelés hatókörében vagy alatt található-e.

properties.description

string

A szabályzatmentesség leírása.

properties.displayName

string

A szabályzatkivétel megjelenítendő neve.

properties.expiresOn

string

A szabályzat kivételének lejárati dátuma és időpontja (UTC ISO 8601 formátumban yyyy-MM-ddTHH:mm:ssZ).

properties.metadata

object

A szabályzat kivételének metaadatai. A metaadatok egy nyitott befejezett objektum, amely általában kulcsértékpárok gyűjteménye.

properties.policyDefinitionReferenceIds

string[]

A szabályzatdefiníció referencia-azonosítójának listája, ha a társított szabályzat-hozzárendelés egy szabályzatkészlet-definíció hozzárendelése.

properties.resourceSelectors

ResourceSelector[]

Az erőforrás-választó lista, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.

Válaszok

Name Típus Description
200 OK

PolicyExemption

OK – A frissített szabályzat kivételére vonatkozó információkat adja vissza.

201 Created

PolicyExemption

Létrehozva – Az új szabályzat kivételével kapcsolatos információkat adja vissza.

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

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

Definíciók

Name Description
AssignmentScopeValidation

Az a lehetőség, hogy a kivétel ellenőrzése a hozzárendelés hatókörében vagy alatt található-e.

CloudError

Egy szabályzatművelet hibaválasza.

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorResponse

Hibaválasz

exemptionCategory

A szabályzatmentességi kategória. Lehetséges értékek: Lemondás és Enyhítve.

PolicyExemption

A szabályzat kivétele.

ResourceSelector

Az erőforrás-választó, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.

Selector

A választókifejezés.

SelectorKind

A választó típusa.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AssignmentScopeValidation

Az a lehetőség, hogy a kivétel ellenőrzése a hozzárendelés hatókörében vagy alatt található-e.

Name Típus Description
Default

string

Ezzel a beállítással ellenőrizheti, hogy a kivétel a hozzárendelés hatókörében van-e.

DoNotValidate

string

Ez a beállítás megkerüli azt az ellenőrzést, amelynél a kivétel hatóköre a szabályzat-hozzárendelés hatókörében vagy alatt található.

CloudError

Egy szabályzatművelet hibaválasza.

Name Típus Description
error

ErrorResponse

Hibaválasz
Az azure Resource Manager API-k gyakori hibaválasza a meghiúsult műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

createdByType

Az erőforrást létrehozó identitás típusa.

Name Típus Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további adattípus.

ErrorResponse

Hibaválasz

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorResponse[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célja.

exemptionCategory

A szabályzatmentességi kategória. Lehetséges értékek: Lemondás és Enyhítve.

Name Típus Description
Mitigated

string

Ez a kivételkategória általában azt jelenti, hogy a kockázatcsökkentési műveleteket alkalmazták a hatókörre.

Waiver

string

Ez a kivételkategória általában azt jelenti, hogy a hatókör nem alkalmazható a szabályzatra.

PolicyExemption

A szabályzat kivétele.

Name Típus Alapértelmezett érték Description
id

string

A szabályzatmentesség azonosítója.

name

string

A szabályzat kivételének neve.

properties.assignmentScopeValidation

AssignmentScopeValidation

Default

Az a lehetőség, hogy a kivétel ellenőrzése a hozzárendelés hatókörében vagy alatt található-e.

properties.description

string

A szabályzatmentesség leírása.

properties.displayName

string

A szabályzatkivétel megjelenítendő neve.

properties.exemptionCategory

exemptionCategory

A szabályzatmentességi kategória. Lehetséges értékek: Lemondás és Enyhítve.

properties.expiresOn

string

A szabályzat kivételének lejárati dátuma és időpontja (UTC ISO 8601 formátumban yyyy-MM-ddTHH:mm:ssZ).

properties.metadata

object

A szabályzat kivételének metaadatai. A metaadatok egy nyitott befejezett objektum, amely általában kulcsértékpárok gyűjteménye.

properties.policyAssignmentId

string

A mentesített szabályzat-hozzárendelés azonosítója.

properties.policyDefinitionReferenceIds

string[]

A szabályzatdefiníció referencia-azonosítójának listája, ha a társított szabályzat-hozzárendelés egy szabályzatkészlet-definíció hozzárendelése.

properties.resourceSelectors

ResourceSelector[]

Az erőforrás-választó lista, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.

systemData

systemData

Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatokat.

type

string

Az erőforrás típusa (Microsoft.Authorization/policyExemptions).

ResourceSelector

Az erőforrás-választó, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.

Name Típus Description
name

string

Az erőforrás-választó neve.

selectors

Selector[]

A választókifejezések listája.

Selector

A választókifejezés.

Name Típus Description
in

string[]

A szűrni kívánt értékek listája.

kind

SelectorKind

A választó típusa.

notIn

string[]

A kiszűrni kívánt értékek listája.

SelectorKind

A választó típusa.

Name Típus Description
policyDefinitionReferenceId

string

A szabályzatok szabályzatdefiníció referencia-azonosító alapján történő szűrésére szolgáló választótípus.

resourceLocation

string

A szabályzatok erőforráshely szerinti szűrésére vonatkozó választótípus.

resourceType

string

A szabályzatok erőforrástípus szerinti szűrésére vonatkozó választótípus.

resourceWithoutLocation

string

A választó típusa a szabályzatok hely nélküli erőforrás szerinti szűréséhez.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást utoljára módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.