Policy Assignments - Create By Id

Szolgáltatás:: Policy

API-verzió:: 2025-01-01

Szabályzat-hozzárendelést hoz létre vagy frissít.
Ez a művelet létrehozza vagy frissíti a politika kiosztást a megadott azonosítóval. A területen végzett szabályzatkiosztások minden abban a hatótávban található erőforrásra vonatkoznak. Például, amikor egy szabályzatot rendelsz egy erőforráscsoporthoz, az a politika minden erőforrásra vonatkozik a csoportban. A szabályzat hozzárendelési azonosítók a következő formátumúak: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Érvényes hatótávok: management group (formátum: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), előfizetés (formátum: '/subscriptions/{subscriptionId}'), erőforrás-csoport (formátum: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', vagy erőforrás (formátum: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

PUT https://management.azure.com/{policyAssignmentId}?api-version=2025-01-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
policyAssignmentId	path	True	string	A létrehozandó politika azonosítója. Használja a következő formátumot: "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
identity	Identity	A szabályzat-hozzárendeléshez társított felügyelt identitás.
location	string	A szabályzat-hozzárendelés helye. Csak felügyelt identitás használatakor szükséges.
properties.assignmentType	assignmentType	A szabályzat-hozzárendelés típusa. A lehetséges értékek nem meghatározottak, Rendszer, SystemHidden és Egyéni. Megváltoztathatatlan.
properties.definitionVersion	string	A használni kívánt szabályzatdefiníció verziója.
properties.description	string	Ez az üzenet a szabályzat megsértése esetén a válasz része lesz.
properties.displayName	string	A szabályzat-hozzárendelés megjelenítendő neve.
properties.enforcementMode	enforcementMode	A szabályzat-hozzárendelés kényszerítési módja. Lehetséges értékek: Default, DoNotEnforce és Enroll
properties.metadata	object	A szabályzat-hozzárendelés metaadatai. A metaadatok egy nyitott végű objektum, amely általában kulcsértékpárok gyűjteménye.
properties.nonComplianceMessages	NonComplianceMessage[]	Azok az üzenetek, amelyek azt írják le, hogy egy erőforrás miért nem felel meg a szabályzatnak.
properties.notScopes	string[]	A szabályzat kizárt hatókörei.
properties.overrides	Override[]	A szabályzat tulajdonságértékének felülbírálása.
properties.parameters	<string, ParameterValuesValue>	A hozzárendelt szabályzatszabály paraméterértékei. A kulcsok a paraméternevek.
properties.policyDefinitionId	string	A hozzárendelt szabályzatdefiníció vagy szabályzatkészlet-definíció azonosítója.
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
201 Created	PolicyAssignment	Létrehozva – Információt küld vissza a kötvény kiosztásáról.
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

Create or update policy assignment by ID

Create or update policy assignment with a managed identity by ID

Create or update policy assignment by ID

Mintakérelem

HTTP

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

{
  "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",
    "definitionVersion": "1.*.*",
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default"
  }
}

Mintaválasz

Állapotkód:: 201

{
  "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",
    "definitionVersion": "1.*.*",
    "notScopes": [],
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default",
    "instanceId": "b7e0f8a9-1c2d-4e3f-8b4c-5d6e7f8a9b0c"
  },
  "id": "/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "LowCostStorage"
}

Create or update policy assignment with a managed identity by ID

Mintakérelem

HTTP

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

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "eastus",
  "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",
    "definitionVersion": "1.*.*",
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default"
  }
}

Mintaválasz

Állapotkód:: 201

{
  "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",
    "definitionVersion": "1.*.*",
    "notScopes": [],
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default",
    "instanceId": "b7e0f8a9-1c2d-4e3f-8b4c-5d6e7f8a9b0c"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "e6d23f8d-af97-4fbc-bda6-00604e4e3d0a",
    "tenantId": "4bee2b8a-1bee-47c2-90e9-404241551135"
  },
  "location": "eastus",
  "id": "/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "LowCostStorage"
}

Definíciók

Name	Description
assignmentType	A szabályzat-hozzárendelés típusa. A lehetséges értékek nem meghatározottak, Rendszer, SystemHidden és Egyéni. Megváltoztathatatlan.
CloudError	Egy szabályzatművelet hibaválasza.
createdByType	Az erőforrást létrehozó identitás típusa.
enforcementMode	A szabályzat-hozzárendelés kényszerítési módja. Lehetséges értékek: Default, DoNotEnforce és Enroll
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorResponse	Hibaválasz
Identity	Az erőforrás identitása. A szabályzatok kijelölései legfeljebb egy identitást támogatnak. Ez vagy egy rendszerhez adott identitás, vagy egyetlen felhasználó által kijelölt identitás.
NonComplianceMessage	Üzenet, amely leírja, hogy egy erőforrás miért nem felel meg a szabályzatnak. Ez a "megtagadás" hibaüzenetekben és az erőforrás nem megfelelő megfelelőségi eredményeiben jelenik meg.
Override	A szabályzat tulajdonságértékének felülbírálása.
OverrideKind	A felülbírálás típusa.
ParameterValuesValue	Egy paraméter értéke.
PolicyAssignment	A szabályzati kiosztás.
ResourceIdentityType	Az identitás típusa. Ez az egyetlen kötelező mező, amikor rendszer- vagy felhasználó által hozzárendelt identitást ad hozzá egy erőforráshoz.
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.
UserAssignedIdentities	A szabályzathoz társított felhasználói identitás. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

assignmentType

Felsorolás

A szabályzat-hozzárendelés típusa. A lehetséges értékek nem meghatározottak, Rendszer, SystemHidden és Egyéni. Megváltoztathatatlan.

Érték	Description
NotSpecified
System
SystemHidden
Custom

CloudError

Tárgy

Egy szabályzatművelet hibaválasza.

Name	Típus	Description
error	ErrorResponse	Hibaválasz Gyakori hibaválasz minden Azure Resource Manager API-hoz, hogy hibaadatokat adjon vissza a sikertelen műveletek esetén. (Ez az OData hibaválasz formátumát is követi.)

createdByType

Felsorolás

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

Érték	Description
User
Application
ManagedIdentity
Key

enforcementMode

Felsorolás

A szabályzat-hozzárendelés kényszerítési módja. Lehetséges értékek: Default, DoNotEnforce és Enroll

Érték	Description
Default	A szabályzathatás érvényesül az erőforrás létrehozása vagy frissítése során.
DoNotEnforce	A szabályzat hatása nem érvényesíti az erőforrás-létrehozás vagy frissítés során.
Enroll	A szabályzat hatása nem érvényesül az erőforrás-létrehozás vagy frissítés során, amíg az erőforrás vagy az erőforrás hatóköre be nem kerül a hozzárendelési példányba. A regisztráció a szabályzati regisztrációs erőforrás telepítésekor történik.

ErrorAdditionalInfo

Tárgy

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 információtípus.

ErrorResponse

Tárgy

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 hibacél.

Identity

Tárgy

Az erőforrás identitása. A szabályzatok kijelölései legfeljebb egy identitást támogatnak. Ez vagy egy rendszerhez adott identitás, vagy egyetlen felhasználó által kijelölt identitás.

Name	Típus	Description
principalId	string	Az erőforrás identitásának fő azonosítója. Ez a tulajdonság csak egy rendszerhez rendelt identitás esetén lesz elérhető
tenantId	string	Az erőforrás identitásának bérlőazonosítója. Ez a tulajdonság csak egy rendszerhez rendelt identitás esetén lesz elérhető
type	ResourceIdentityType	Az identitás típusa. Ez az egyetlen kötelező mező, amikor rendszer- vagy felhasználó által hozzárendelt identitást ad hozzá egy erőforráshoz.
userAssignedIdentities	UserAssignedIdentities	A szabályzathoz társított felhasználói identitás. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

NonComplianceMessage

Tárgy

Üzenet, amely leírja, hogy egy erőforrás miért nem felel meg a szabályzatnak. Ez a "megtagadás" hibaüzenetekben és az erőforrás nem megfelelő megfelelőségi eredményeiben jelenik meg.

Name	Típus	Description
message	string	Üzenet, amely leírja, hogy egy erőforrás miért nem felel meg a szabályzatnak. Ez a "megtagadás" hibaüzenetekben és az erőforrás nem megfelelő megfelelőségi eredményeiben jelenik meg.
policyDefinitionReferenceId	string	A szabályzatdefiníció referencia-azonosítója egy szabályzatkészlet-definícióban, amelynek az üzenet a célja. Ez csak akkor alkalmazható, ha a szabályzat-hozzárendelés hozzárendel egy szabályzatkészlet-definíciót. Ha ez nem jelenik meg, az üzenet a szabályzat-hozzárendelés által hozzárendelt összes házirendre vonatkozik.

Override

Tárgy

A szabályzat tulajdonságértékének felülbírálása.

Name	Típus	Description
kind	OverrideKind	A felülbírálás típusa.
selectors	Selector[]	A választókifejezések listája.
value	string	A szabályzattulajdonság felülbírálandó értéke.

OverrideKind

Felsorolás

A felülbírálás típusa.

Érték	Description
policyEffect	Ez felülírja a politikahatás típusát.
definitionVersion	Ez felülírja a szabályzat definíciós verzió tulajdonságértékét.

ParameterValuesValue

Tárgy

Egy paraméter értéke.

Name	Típus	Description
value		A paraméter értéke.