Microsoft.Authorization policyAssignments 2021-06-01

Definicja zasobu Bicep

Typ zasobu policyAssignments to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

scope Użyj właściwości w tym zasobie, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w aplikacji Bicep.

Typ zasobu policyAssignments można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Authorization/policyAssignments, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

policyAssignments

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–128 nazwa wyświetlana

1–64 nazwa zasobu

1–24 nazwa zasobu w zakresie grupy zarządzania

Prawidłowe znaki:
Nazwa wyświetlana może zawierać dowolne znaki.

Nazwa zasobu nie może być używana:
<>*%&:\?.+/ lub znaki sterujące.

Nie można zakończyć kropką ani spacją.
location Lokalizacja przypisania zasad. Wymagane tylko w przypadku korzystania z tożsamości zarządzanej. ciąg
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

Dla Bicep ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
identity Tożsamość zarządzana skojarzona z przypisaniem zasad. Tożsamość
properties Właściwości przypisania zasad. PolicyAssignmentProperties

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. Jest to jedyne pole wymagane podczas dodawania tożsamości przypisanej przez system lub użytkownika do zasobu. "Brak"
"SystemAssigned"
"UserAssigned"
userAssignedIdentities Tożsamość użytkownika skojarzona z zasadami. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

PolicyAssignmentProperties

Nazwa Opis Wartość
description (opis) Ten komunikat będzie częścią odpowiedzi w przypadku naruszenia zasad. ciąg
displayName Nazwa wyświetlana przypisania zasad. ciąg
enforcementMode Tryb wymuszania przypisania zasad. Możliwe wartości to Default i DoNotEnforce. "Wartość domyślna"
"DoNotEnforce"
metadane Metadane przypisania zasad. Metadane są otwartym obiektem końcowym i zazwyczaj jest kolekcją par klucz-wartość. W przypadku funkcji Bicep można użyć funkcji any().
nonComplianceMessages Komunikaty opisujące, dlaczego zasób jest niezgodny z zasadami. NonComplianceMessage[]
notScopes Wykluczone zakresy zasad. ciąg[]
parameters Wartości parametrów dla przypisanej reguły zasad. Klucze są nazwami parametrów. Parametervalues
policyDefinitionId Identyfikator przypisywanej definicji zasad lub definicji zestawu zasad. ciąg

NonComplianceMessage

Nazwa Opis Wartość
message Komunikat opisujący, dlaczego zasób jest niezgodny z zasadami. Jest to wyświetlane w komunikatach o błędach "odmów" i wynikach niezgodności zasobu. ciąg (wymagany)
policyDefinitionReferenceId Identyfikator odwołania definicji zasad w definicji zestawu zasad, dla których jest przeznaczony komunikat. Ma to zastosowanie tylko wtedy, gdy przypisanie zasad przypisuje definicję zestawu zasad. Jeśli nie zostanie podany komunikat dotyczy wszystkich zasad przypisanych przez to przypisanie zasad. ciąg

Parametervalues

Nazwa Opis Wartość
{niestandardowa właściwość} ParameterValuesValue

ParameterValuesValue

Nazwa Opis Wartość
wartość Wartość parametru. W przypadku funkcji Bicep można użyć funkcji any().

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Wdrażanie definicji zasad i przypisywanie do grupy zarządzania

Wdróż na platformie Azure
Ten szablon jest szablonem na poziomie grupy zarządzania, który utworzy definicję zasad i przypisze te zasady do docelowej grupy zarządzania. Obecnie nie można wdrożyć tego szablonu za pośrednictwem witryny Azure Portal.
Wdrażanie def i przypisywanie zasad do wielu Grupy mgmt

Wdróż na platformie Azure
Ten szablon jest szablonem na poziomie grupy zarządzania, który utworzy definicję zasad i przypisze te zasady do wielu grup zarządzania.
Przypisywanie wbudowanych zasad do istniejącej grupy zasobów

Wdróż na platformie Azure
Ten szablon przypisuje wbudowane zasady do istniejącej grupy zasobów.
Twórca menedżera usługi Azure Virtual Network Manager i przykładowych sieci wirtualnych

Wdróż na platformie Azure
Ten szablon służy do wdrażania usługi Azure Virtual Network Manager i przykładowych sieci wirtualnych w nazwanej grupie zasobów. Obsługuje wiele topologii łączności i typów członkostwa w grupach sieci.

Definicja zasobu szablonu usługi ARM

Typ zasobu policyAssignments to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

scope Użyj właściwości w tym zasobie, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w szablonach usługi ARM.

Typ zasobu policyAssignments można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Authorization/policyAssignments, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

policyAssignments

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Authorization/policyAssignments"
apiVersion Wersja interfejsu API zasobów '2021-06-01'
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–128 nazwa wyświetlana

1–64 nazwa zasobu

1–24 nazwa zasobu w zakresie grupy zarządzania

Prawidłowe znaki:
Nazwa wyświetlana może zawierać dowolne znaki.

Nazwa zasobu nie może być używana:
<>*%&:\?.+/ lub znaki sterujące.

Nie można zakończyć kropką ani spacją.
location Lokalizacja przypisania zasad. Wymagane tylko w przypadku korzystania z tożsamości zarządzanej. ciąg
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku formatu JSON ustaw wartość na pełną nazwę zasobu, aby zastosować zasób rozszerzenia do.
identity Tożsamość zarządzana skojarzona z przypisaniem zasad. Tożsamość
properties Właściwości przypisania zasad. PolicyAssignmentProperties

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. Jest to jedyne wymagane pole podczas dodawania tożsamości przypisanej przez system lub użytkownika do zasobu. "Brak"
"SystemAssigned"
"UserAssigned"
userAssignedIdentities Tożsamość użytkownika skojarzona z zasadami. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

PolicyAssignmentProperties

Nazwa Opis Wartość
description (opis) Ten komunikat będzie częścią odpowiedzi w przypadku naruszenia zasad. ciąg
displayName Nazwa wyświetlana przypisania zasad. ciąg
enforcementMode Tryb wymuszania przypisania zasad. Możliwe wartości to Default i DoNotEnforce. "Wartość domyślna"
"DoNotEnforce"
metadane Metadane przypisania zasad. Metadane to otwarty obiekt i zazwyczaj jest kolekcją par klucz wartości.
nonComplianceMessages Komunikaty opisujące, dlaczego zasób jest niezgodny z zasadami. NonComplianceMessage[]
notScopes Wykluczone zakresy zasad. ciąg[]
parameters Wartości parametrów przypisanej reguły zasad. Klucze są nazwami parametrów. Parametervalues
policyDefinitionId Identyfikator przypisywanej definicji zasad lub definicji zestawu zasad. ciąg

NonComplianceMessage

Nazwa Opis Wartość
message Komunikat opisujący, dlaczego zasób jest niezgodny z zasadami. Jest to wyświetlane w komunikatach o błędach "odmów" i na niezgodnych wynikach zgodności zasobu. ciąg (wymagany)
policyDefinitionReferenceId Identyfikator odwołania definicji zasad w definicji zestawu zasad, dla których jest przeznaczony komunikat. Ma to zastosowanie tylko wtedy, gdy przypisanie zasad przypisuje definicję zestawu zasad. Jeśli nie zostanie podany komunikat dotyczy wszystkich zasad przypisanych przez to przypisanie zasad. ciąg

Parametervalues

Nazwa Opis Wartość
{niestandardowa właściwość} ParameterValuesValue

ParameterValuesValue

Nazwa Opis Wartość
wartość Wartość parametru.

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Wdrażanie definicji zasad i przypisywanie do grupy zarządzania

Wdróż na platformie Azure
Ten szablon jest szablonem na poziomie grupy zarządzania, który utworzy definicję zasad i przypisze te zasady do docelowej grupy zarządzania. Obecnie nie można wdrożyć tego szablonu za pośrednictwem witryny Azure Portal.
Wdrażanie def i przypisywanie zasad do wielu Grupy mgmt

Wdróż na platformie Azure
Ten szablon jest szablonem na poziomie grupy zarządzania, który utworzy definicję zasad i przypisze te zasady do wielu grup zarządzania.
Przypisywanie wbudowanych zasad do istniejącej grupy zasobów

Wdróż na platformie Azure
Ten szablon przypisuje wbudowane zasady do istniejącej grupy zasobów.
Twórca menedżera usługi Azure Virtual Network i przykładowych sieci wirtualnych

Wdróż na platformie Azure
Ten szablon wdraża usługę Azure Virtual Network Manager i przykładowe sieci wirtualne w nazwanej grupie zasobów. Obsługuje ona wiele topologii łączności i typów członkostwa w grupach sieciowych.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu policyAssignments to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

parent_id Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu.

Typ zasobu policyAssignments można wdrożyć z operacjami docelowymi:

  • Grupy zasobów
  • Subskrypcje
  • Grupy zarządzania

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Authorization/policyAssignments, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

policyAssignments

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Authorization/policyAssignments@2021-06-01"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–128 nazwa wyświetlana

1–64 nazwa zasobu

1–24 nazwa zasobu w zakresie grupy zarządzania

Prawidłowe znaki:
Nazwa wyświetlana może zawierać dowolne znaki.

Nazwa zasobu nie może być używana:
<>*%&:\?.+/ lub znaki sterujące.

Nie można zakończyć kropką ani spacją.
location Lokalizacja przypisania zasad. Wymagane tylko w przypadku korzystania z tożsamości zarządzanej. ciąg
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
identity Tożsamość zarządzana skojarzona z przypisaniem zasad. Tożsamość
properties Właściwości przypisania zasad. PolicyAssignmentProperties

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. Jest to jedyne wymagane pole podczas dodawania tożsamości przypisanej przez system lub użytkownika do zasobu. "SystemAssigned"
"UserAssigned"
identity_ids Tożsamość użytkownika skojarzona z zasadami. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Tablica identyfikatorów tożsamości użytkownika.

IdentityUserAssignedIdentities

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentitiesValue

UserAssignedIdentitiesValue

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

PolicyAssignmentProperties

Nazwa Opis Wartość
description (opis) Ten komunikat będzie częścią odpowiedzi w przypadku naruszenia zasad. ciąg
displayName Nazwa wyświetlana przypisania zasad. ciąg
enforcementMode Tryb wymuszania przypisania zasad. Możliwe wartości to Default i DoNotEnforce. "Wartość domyślna"
"DoNotEnforce"
metadane Metadane przypisania zasad. Metadane to otwarty obiekt i zazwyczaj jest kolekcją par klucz wartości.
nonComplianceMessages Komunikaty opisujące, dlaczego zasób jest niezgodny z zasadami. NonComplianceMessage[]
notScopes Wykluczone zakresy zasad. ciąg[]
parameters Wartości parametrów przypisanej reguły zasad. Klucze są nazwami parametrów. Parametervalues
policyDefinitionId Identyfikator przypisywanej definicji zasad lub definicji zestawu zasad. ciąg

NonComplianceMessage

Nazwa Opis Wartość
message Komunikat opisujący, dlaczego zasób jest niezgodny z zasadami. Jest to wyświetlane w komunikatach o błędach "odmów" i na niezgodnych wynikach zgodności zasobu. ciąg (wymagany)
policyDefinitionReferenceId Identyfikator odwołania definicji zasad w definicji zestawu zasad, dla których jest przeznaczony komunikat. Ma to zastosowanie tylko wtedy, gdy przypisanie zasad przypisuje definicję zestawu zasad. Jeśli nie zostanie podany komunikat dotyczy wszystkich zasad przypisanych przez to przypisanie zasad. ciąg

Parametervalues

Nazwa Opis Wartość
{niestandardowa właściwość} ParameterValuesValue

ParameterValuesValue

Nazwa Opis Wartość
wartość Wartość parametru.