Microsoft.Authorization/policyAssignments 2021-06-01 - Bicep, ARM template & Terraform AzAPI reference

Bicep-resursdefinition

Resurstypen policyAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.

Använd egenskapen scope på den här resursen för att ange resursens omfång. Se Ange omfång för tilläggsresurser i Bicep.

Resurstypen policyAssignments kan distribueras med åtgärder som mål:

Resursgrupper – Se resursgruppsdistributionskommandon
Prenumerationer – Se distributionskommandon för prenumerationer
Hanteringsgrupper – Se distributionskommandon för hanteringsgrupp

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Authorization/policyAssignments-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Authorization/policyAssignments@2021-06-01' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    description: 'string'
    displayName: 'string'
    enforcementMode: 'string'
    metadata: any()
    nonComplianceMessages: [
      {
        message: 'string'
        policyDefinitionReferenceId: 'string'
      }
    ]
    notScopes: [
      'string'
    ]
    parameters: {
      {customized property}: {
        value: any()
      }
    }
    policyDefinitionId: 'string'
  }
}

Egenskapsvärden

policyAssignments

Namn	Beskrivning	Värde
Namn	Resursnamnet	sträng (krävs) Teckengräns: 1–128 visningsnamn 1–64 resursnamn 1–24 resursnamn i hanteringsgruppens omfång Giltiga tecken: Visningsnamnet kan innehålla alla tecken. Resursnamnet kan inte användas: `<>*%&:\?.+/` eller kontrolltecken. Det går inte att avsluta med punkt eller blanksteg.
plats	Platsen för principtilldelningen. Krävs endast vid användning av hanterad identitet.	sträng
omfattning	Använd när du skapar en tilläggsresurs i ett omfång som skiljer sig från distributionsomfånget.	Målresurs För Bicep anger du den här egenskapen till det symboliska namnet på resursen för att tillämpa -tilläggsresursen.
identitet	Den hanterade identitet som är associerad med principtilldelningen.	identitet
Egenskaper	Egenskaper för principtilldelningen.	PolicyAssignmentProperties

Identitet

Namn	Beskrivning	Värde
typ	Identitetstypen. Det här är det enda obligatoriska fältet när du lägger till en system- eller användartilldelad identitet till en resurs.	"Ingen" "SystemAssigned" "UserAssigned"
userAssignedIdentities	Användaridentiteten som är associerad med principen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentiteter

IdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde
{anpassad egenskap}		UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.

PolicyAssignmentProperties

Namn	Beskrivning	Värde
beskrivning	Det här meddelandet är en del av svaret i händelse av principöverträdelse.	sträng
displayName	Visningsnamnet för principtilldelningen.	sträng
enforcementMode	Tvingande läge för principtilldelning. Möjliga värden är Standard och DoNotEnforce.	"Standard" "DoNotEnforce"
metadata	Metadata för principtilldelning. Metadata är ett öppet slutobjekt och är vanligtvis en samling nyckelvärdepar.	För Bicep kan du använda funktionen any().
nonComplianceMessages	Meddelandena som beskriver varför en resurs inte är kompatibel med principen.	NonComplianceMessage[]
notScopes	Principens undantagna omfång.	string[]
Parametrar	Parametervärdena för den tilldelade principregeln. Nycklarna är parameternamnen.	ParameterValues
policyDefinitionId	ID:t för den principdefinition eller principuppsättningsdefinition som tilldelas.	sträng

NonComplianceMessage

Namn	Beskrivning	Värde
meddelande	Ett meddelande som beskriver varför en resurs inte är kompatibel med principen. Detta visas i felmeddelanden om neka och på resursens icke-kompatibla efterlevnadsresultat.	sträng (krävs)
policyDefinitionReferenceId	Referens-ID:t för principdefinitionen i en principuppsättningsdefinition som meddelandet är avsett för. Detta gäller endast om principtilldelningen tilldelar en principuppsättningsdefinition. Om detta inte anges gäller meddelandet för alla principer som tilldelats av den här principtilldelningen.	sträng

ParameterValues

Namn	Beskrivning	Värde
{anpassad egenskap}		ParameterValuesValue

ParameterValuesValue

Namn	Beskrivning	Värde
värde	Värdet för parametern.	För Bicep kan du använda funktionen any().

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Beskrivning
Distribuera en principdefinition och tilldela till en hanteringsgrupp	Den här mallen är en mall på hanteringsgruppsnivå som skapar en principdefinition och tilldelar principen till målhanteringsgruppen. Den här mallen kan för närvarande inte distribueras via Azure-portalen.
Distribuera en principdetribuering och tilldela till flera Mgmt-grupper	Den här mallen är en mall på hanteringsgruppsnivå som skapar en principdefinition och tilldelar principen till flera hanteringsgrupper.
Tilldela en inbyggd princip till en befintlig resursgrupp	Den här mallen tilldelar en inbyggd princip till en befintlig resursgrupp.
Tilldela inbyggd princip för granskning av virtuella datorhanterade diskar	Den här mallen tilldelar en inbyggd princip till ett resursgruppsomfång för granskning av virtuella datorhanterade diskar.
Skapa en Azure Virtual Network Manager och exempel på virtuella nätverk	Den här mallen distribuerar en Azure Virtual Network Manager och exempel på virtuella nätverk till den namngivna resursgruppen. Den stöder flera anslutningstopologier och medlemskapstyper för nätverksgrupper.

Resursdefinition för ARM-mall

Resurstypen policyAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.

Använd egenskapen scope på den här resursen för att ange resursens omfång. Se Ange omfång för tilläggsresurser i ARM-mallar.

Resurstypen policyAssignments kan distribueras med åtgärder som mål:

Resursgrupper – Se resursgruppsdistributionskommandon
Prenumerationer – Se distributionskommandon för prenumerationer
Hanteringsgrupper – Se distributionskommandon för hanteringsgrupp

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Authorization/policyAssignments-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Authorization/policyAssignments",
  "apiVersion": "2021-06-01",
  "name": "string",
  "location": "string",
  "scope": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "description": "string",
    "displayName": "string",
    "enforcementMode": "string",
    "metadata": {},
    "nonComplianceMessages": [
      {
        "message": "string",
        "policyDefinitionReferenceId": "string"
      }
    ],
    "notScopes": [ "string" ],
    "parameters": {
      "{customized property}": {
        "value": {}
      }
    },
    "policyDefinitionId": "string"
  }
}

Egenskapsvärden

policyAssignments

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.Authorization/policyAssignments"
apiVersion	Resurs-API-versionen	'2021-06-01'
Namn	Resursnamnet	sträng (krävs) Teckengräns: 1–128 visningsnamn 1–64 resursnamn 1–24 resursnamn i hanteringsgruppens omfång Giltiga tecken: Visningsnamnet kan innehålla alla tecken. Resursnamnet kan inte användas: `<>*%&:\?.+/` eller kontrolltecken. Det går inte att avsluta med punkt eller blanksteg.
plats	Platsen för principtilldelningen. Krävs endast vid användning av hanterad identitet.	sträng
omfattning	Använd när du skapar en tilläggsresurs i ett omfång som skiljer sig från distributionsomfånget.	Målresurs För JSON anger du värdet till det fullständiga namnet på resursen som tilläggsresursen på.
identitet	Den hanterade identitet som är associerad med principtilldelningen.	identitet
Egenskaper	Egenskaper för principtilldelningen.	PolicyAssignmentProperties

Identitet

Namn	Beskrivning	Värde
typ	Identitetstypen. Det här är det enda obligatoriska fältet när du lägger till en system- eller användartilldelad identitet till en resurs.	"Ingen" "SystemAssigned" "UserAssigned"
userAssignedIdentities	Användaridentiteten som är associerad med principen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentiteter

IdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde
{anpassad egenskap}		UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.

PolicyAssignmentProperties

Namn	Beskrivning	Värde
beskrivning	Det här meddelandet är en del av svaret i händelse av principöverträdelse.	sträng
displayName	Visningsnamnet för principtilldelningen.	sträng
enforcementMode	Tvingande läge för principtilldelning. Möjliga värden är Standard och DoNotEnforce.	"Standard" "DoNotEnforce"
metadata	Metadata för principtilldelning. Metadata är ett öppet slutobjekt och är vanligtvis en samling nyckelvärdepar.
nonComplianceMessages	Meddelandena som beskriver varför en resurs inte är kompatibel med principen.	NonComplianceMessage[]
notScopes	Principens undantagna omfång.	string[]
Parametrar	Parametervärdena för den tilldelade principregeln. Nycklarna är parameternamnen.	ParameterValues
policyDefinitionId	ID:t för den principdefinition eller principuppsättningsdefinition som tilldelas.	sträng

NonComplianceMessage

Namn	Beskrivning	Värde
meddelande	Ett meddelande som beskriver varför en resurs inte är kompatibel med principen. Detta visas i felmeddelanden om neka och på resursens icke-kompatibla efterlevnadsresultat.	sträng (krävs)
policyDefinitionReferenceId	Referens-ID:t för principdefinitionen i en principuppsättningsdefinition som meddelandet är avsett för. Detta gäller endast om principtilldelningen tilldelar en principuppsättningsdefinition. Om detta inte anges gäller meddelandet för alla principer som tilldelats av den här principtilldelningen.	sträng

ParameterValues

Namn	Beskrivning	Värde
{anpassad egenskap}		ParameterValuesValue

ParameterValuesValue

Namn	Beskrivning	Värde
värde	Värdet för parametern.

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Beskrivning
Distribuera en principdefinition och tilldela till en hanteringsgrupp	Den här mallen är en mall på hanteringsgruppsnivå som skapar en principdefinition och tilldelar principen till målhanteringsgruppen. Den här mallen kan för närvarande inte distribueras via Azure-portalen.
Distribuera en principdetribuering och tilldela till flera Mgmt-grupper	Den här mallen är en mall på hanteringsgruppsnivå som skapar en principdefinition och tilldelar principen till flera hanteringsgrupper.
Tilldela en inbyggd princip till en befintlig resursgrupp	Den här mallen tilldelar en inbyggd princip till en befintlig resursgrupp.
Tilldela inbyggd princip för granskning av virtuella datorhanterade diskar	Den här mallen tilldelar en inbyggd princip till ett resursgruppsomfång för granskning av virtuella datorhanterade diskar.
Skapa en Azure Virtual Network Manager och exempel på virtuella nätverk	Den här mallen distribuerar en Azure Virtual Network Manager och exempel på virtuella nätverk till den namngivna resursgruppen. Den stöder flera anslutningstopologier och medlemskapstyper för nätverksgrupper.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen policyAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.

Använd egenskapen parent_id på den här resursen för att ange resursens omfång.

Resurstypen policyAssignments kan distribueras med åtgärder som mål:

Resursgrupper
prenumerationer
Hanteringsgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Authorization/policyAssignments-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policyAssignments@2021-06-01"
  name = "string"
  location = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      description = "string"
      displayName = "string"
      enforcementMode = "string"
      nonComplianceMessages = [
        {
          message = "string"
          policyDefinitionReferenceId = "string"
        }
      ]
      notScopes = [
        "string"
      ]
      parameters = {
        {customized property} = {}
      }
      policyDefinitionId = "string"
    }
  })
}

Egenskapsvärden

policyAssignments

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.Authorization/policyAssignments@2021-06-01"
Namn	Resursnamnet	sträng (krävs) Teckengräns: 1–128 visningsnamn 1–64 resursnamn 1–24 resursnamn i hanteringsgruppens omfång Giltiga tecken: Visningsnamnet kan innehålla alla tecken. Resursnamnet kan inte användas: `<>*%&:\?.+/` eller kontrolltecken. Det går inte att avsluta med punkt eller blanksteg.
plats	Platsen för principtilldelningen. Krävs endast vid användning av hanterad identitet.	sträng
parent_id	ID:t för resursen som den här tilläggsresursen ska tillämpas på.	sträng (krävs)
identitet	Den hanterade identitet som är associerad med principtilldelningen.	identitet
Egenskaper	Egenskaper för principtilldelningen.	PolicyAssignmentProperties

Identitet

Namn	Beskrivning	Värde
typ	Identitetstypen. Det här är det enda obligatoriska fältet när du lägger till en system- eller användartilldelad identitet till en resurs.	"SystemAssigned" "UserAssigned"
identity_ids	Användaridentiteten som är associerad med principen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	Matris med användaridentitets-ID:t.

IdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde
{anpassad egenskap}		UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.

PolicyAssignmentProperties

Namn	Beskrivning	Värde
beskrivning	Det här meddelandet är en del av svaret i händelse av principöverträdelse.	sträng
displayName	Visningsnamnet för principtilldelningen.	sträng
enforcementMode	Tvingande läge för principtilldelning. Möjliga värden är Standard och DoNotEnforce.	"Standard" "DoNotEnforce"
metadata	Metadata för principtilldelning. Metadata är ett öppet slutobjekt och är vanligtvis en samling nyckelvärdepar.
nonComplianceMessages	Meddelandena som beskriver varför en resurs inte är kompatibel med principen.	NonComplianceMessage[]
notScopes	Principens undantagna omfång.	string[]
Parametrar	Parametervärdena för den tilldelade principregeln. Nycklarna är parameternamnen.	ParameterValues
policyDefinitionId	ID:t för den principdefinition eller principuppsättningsdefinition som tilldelas.	sträng

NonComplianceMessage

Namn	Beskrivning	Värde
meddelande	Ett meddelande som beskriver varför en resurs inte är kompatibel med principen. Detta visas i felmeddelanden om neka och på resursens icke-kompatibla efterlevnadsresultat.	sträng (krävs)
policyDefinitionReferenceId	Referens-ID:t för principdefinitionen i en principuppsättningsdefinition som meddelandet är avsett för. Detta gäller endast om principtilldelningen tilldelar en principuppsättningsdefinition. Om detta inte anges gäller meddelandet för alla principer som tilldelats av den här principtilldelningen.	sträng

ParameterValues

Namn	Beskrivning	Värde
{anpassad egenskap}		ParameterValuesValue

ParameterValuesValue

Namn	Beskrivning	Värde
värde	Värdet för parametern.

Dela via

Microsoft.Authorization policyAssignments 2021-06-01

Bicep-resursdefinition

Resursformat

Egenskapsvärden

policyAssignments

Identitet

IdentityUserAssignedIdentiteter

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

ParameterValues

ParameterValuesValue

Snabbstartsmallar

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

policyAssignments

Identitet

IdentityUserAssignedIdentiteter

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

ParameterValues

ParameterValuesValue

Snabbstartsmallar

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

policyAssignments

Identitet

IdentityUserAssignedIdentiteter

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

ParameterValues

ParameterValuesValue

Feedback

Ytterligare resurser