Dela via

Tilläggseffekt för Azure Policy-definitioner

Effekten append används för att lägga till fler fält i den begärda resursen när den skapas eller uppdateras. Ett vanligt exempel är att ange tillåtna IP-adresser för en lagringsresurs.

Viktigt!

append är avsedd för användning med egenskaper som inte är taggade. append Även om du kan lägga till taggar i en resurs under en begäran om att skapa eller uppdatera, rekommenderar vi att du istället använder effekten ändra för taggar.

Bifogad utvärdering

Effekten append utvärderas innan begäran bearbetas av en resursprovider när en resurs skapas eller uppdateras. Kommando Lägg till lägger till fält i resursen när villkoret if för regeln för policyn uppfylls. Om tilläggseffekten skulle åsidosätta ett värde i den ursprungliga begäran med ett annat värde fungerar den som en neka-effekt och avvisar begäran. Om du vill lägga till ett nytt värde i en befintlig matris använder du [*] aliasversionen.

När en principdefinition som använder tilläggseffekten körs som en del av en utvärderingscykel, gör den inte ändringar i resurser som redan finns. I stället markeras alla resurser som uppfyller villkoret if som icke-kompatibla.

Lägg till egenskaper

En tilläggseffekt har bara en details matris, vilket krävs. Eftersom details det är en matris kan det ta antingen ett par field/value eller flera. Se definitionsstrukturen för listan över godkända fält.

Tilläggsexempel

Exempel 1: Ett par field/value som använder ett icke-alias[*]med en matris value för att ange IP-regler för ett lagringskonto. När det icke-[*]-aliaset är en matris, appenderas effekten value som en hel matris. Om matrisen redan finns inträffar en deny händelse från konflikten.

"then": {
  "effect": "append",
  "details": [
    {
      "field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules",
      "value": [
        {
          "action": "Allow",
          "value": "134.5.0.0/21"
        }
      ]
    }
  ]
}

Exempel 2: Ett enda field/value par som använder ett [*]alias med en matris value för att ställa in IP-regler på ett lagringskonto. När du använder aliaset [*] läggs effekten till value i en potentiellt befintlig matris. Matriser som inte finns skapas.

"then": {
  "effect": "append",
  "details": [
    {
      "field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules[*]",
      "value": {
        "value": "40.40.40.40",
        "action": "Allow"
      }
    }
  ]
}

Nästa steg