Compartir por

Creación de directivas para propiedades de matriz en recursos de Azure

  • Artigo

Las propiedades de Azure Resource Manager se suelen definir como cadenas y valores booleanos. En cambio, cuando existe una relación uno a varios, las propiedades complejas se definen como matrices. En Azure Policy, las matrices se usan de varias maneras diferentes:

  • Tipo de un parámetro de definición, para proporcionar varias opciones.
  • Parte de una regla de directiva con las condiciones in o notIn.
  • Parte de una regla de directiva que cuenta el número de miembros de la matriz que satisfacen una condición.
  • En los efectos append y modify para actualizar una matriz existente

En este artículo se explica cada uso por parte de Azure Policy y proporciona varias definiciones de ejemplo.

Matrices de parámetros

Definir una matriz de parámetros

Definir un parámetro como una matriz, permite la flexibilidad de la directiva cuando se necesita más de un valor. Esta definición de directiva permite cualquier ubicación única para el parámetro allowedLocations y el valor predeterminado se establece en eastus2:

"parameters": {
  "allowedLocations": {
    "type": "string",
    "metadata": {
      "description": "The list of allowed locations for resources.",
      "displayName": "Allowed locations",
      "strongType": "location"
    },
    "defaultValue": "eastus2"
  }
}

Como el type era string, solo se puede establecer un único valor al asignar la directiva. Si se asigna esta directiva, los recursos del ámbito solo se permiten en una única región de Azure. La mayoría de las definiciones de directivas deben permitir una lista de opciones aprobadas, como permitir eastus2, eastus y westus2.

Para crear la definición de directiva de manera que permita varias opciones, utilice array en la propiedad type. La misma directiva se puede reescribir del siguiente modo:

"parameters": {
  "allowedLocations": {
    "type": "array",
    "metadata": {
      "description": "The list of allowed locations for resources.",
      "displayName": "Allowed locations",
      "strongType": "location"
    },
    "defaultValue": [
      "eastus2"
    ],
    "allowedValues": [
      "eastus2",
      "eastus",
      "westus2"
    ]
  }
}

Nota:

Una vez que se guarda una definición de directiva, no se puede cambiar la propiedad type en un parámetro.

Esta nueva definición de parámetro toma más de un valor durante la asignación de directiva. Una vez definida la propiedad allowedValues de la matriz, los valores disponibles durante la asignación se limitan aún más a la lista predefinida de opciones. El uso de allowedValues es opcional.

Pasar valores a una matriz de parámetros durante la asignación

Al asignar la directiva a través de Azure Portal, un parámetro array de type se muestra como un único cuadro de texto. La sugerencia indica Use ; to separate values. (e.g. London;New York). Para pasar los valores de ubicación permitidos eastus2, eastus y westus2 al parámetro, use la siguiente cadena:

eastus2;eastus;westus2

El formato para el valor del parámetro es distinto cuando se usa la CLI de Azure, Azure PowerShell o la API de REST. Los valores se pasan a través de una cadena JSON que también incluye el nombre del parámetro.

{
  "allowedLocations": {
    "value": [
      "eastus2",
      "eastus",
      "westus2"
    ]
  }
}

Para usar esta cadena con cada SDK, use los siguientes comandos:

  • CLI de Azure: Comando az policy assignment create con el parámetro params.
  • Azure PowerShell: Cmdlet New-AzPolicyAssignment con el parámetro PolicyParameter.
  • API de REST: en la operación PUT create como parte del cuerpo de la solicitud, como el valor de la propiedad properties.parameters.

Uso de matrices en condiciones

In y notIn

Las condiciones in y notIn solo funcionan con valores de matriz. Comprueban la existencia de un valor en una matriz. La matriz puede ser una matriz JSON literal o una referencia a un parámetro de matriz. Por ejemplo:

{
  "field": "tags.environment",
  "in": [
    "dev",
    "test"
  ]
}

{
  "field": "location",
  "notIn": "[parameters('allowedLocations')]"
}

Recuento de valores

La expresión value count cuenta el número de miembros de la matriz que cumplen una condición. Proporciona una manera de evaluar la misma condición varias veces, con valores diferentes en cada iteración. Por ejemplo, la siguiente condición comprueba si el nombre del recurso coincide con algún patrón de una matriz de patrones:

{
  "count": {
    "value": [
      "test*",
      "dev*",
      "prod*"
    ],
    "name": "pattern",
    "where": {
      "field": "name",
      "like": "[current('pattern')]"
    }
  },
  "greater": 0
}

Para evaluar la expresión, Azure Policy evalúa la condición where tres veces, una vez por cada miembro de [ "test*", "dev*", "prod*" ], de modo que cuenta el número de veces que se ha evaluado como true. En cada iteración, el valor del miembro de la matriz actual se empareja con el nombre de índice pattern definido por count.name. Luego se puede hacer referencia a este valor dentro de la condición where si se llama a una función de plantilla especial: current('pattern').

Iteración Valor devuelto por current('pattern')
1 "test*"
2 "dev*"
3 "prod*"

La condición es true solo si el recuento resultante es mayor que 0.

Para que la condición anterior sea más genérica, use una referencia parameters en lugar de una matriz literal:

{
  "count": {
    "value": "[parameters('patterns')]",
    "name": "pattern",
    "where": {
      "field": "name",
      "like": "[current('pattern')]"
    }
  },
  "greater": 0
}

Cuando la expresión value count no está en ninguna otra expresión count, count.name es opcional y se puede usar la función current() sin ningún argumento:

{
  "count": {
    "value": "[parameters('patterns')]",
    "where": {
      "field": "name",
      "like": "[current()]"
    }
  },
  "greater": 0
}

La expresión value count también admite matrices de objetos complejos, lo que permite condiciones más complejas. Por ejemplo, la siguiente condición define un valor de etiqueta deseado para cada patrón de nombre y comprueba si el nombre del recurso coincide con el patrón, pero no tiene el valor de etiqueta necesario:

{
  "count": {
    "value": [
      {
        "pattern": "test*",
        "envTag": "dev"
      },
      {
        "pattern": "dev*",
        "envTag": "dev"
      },
      {
        "pattern": "prod*",
        "envTag": "prod"
      },
    ],
    "name": "namePatternRequiredTag",
    "where": {
      "allOf": [
        {
          "field": "name",
          "like": "[current('namePatternRequiredTag').pattern]"
        },
        {
          "field": "tags.env",
          "notEquals": "[current('namePatternRequiredTag').envTag]"
        }
      ]
    }
  },
  "greater": 0
}

Para obtener ejemplos útiles, vea Ejemplos de value count.

Referencia a las propiedades de recursos de matriz

Muchos casos de uso requieren que trabaje con propiedades de la matriz en el recurso evaluado. Algunos escenarios requieren que haga referencia a una matriz completa (por ejemplo, para comprobar su longitud). Otros requieren que aplique una condición a cada miembro de la matriz individual (por ejemplo, asegúrese de que todas las reglas del firewall bloqueen el acceso desde Internet). Comprender las distintas formas en las que Azure Policy puede hacer referencia a las propiedades de los recursos y cómo se comportan estas referencias cuando se relacionan con las propiedades de la matriz es la clave para escribir condiciones que cubran estos escenarios.

Referencia a las propiedades de recursos

Azure Policy puede hacer referencia a las propiedades de los recursos mediante alias. Hay dos maneras de hacer referencia a los valores de una propiedad de recurso en Azure Policy:

  • Use la condición field para comprobar si todas las propiedades de recursos seleccionadas cumplen una condición. Ejemplo:

    {
  "field": "Microsoft.Test/resourceType/property",
  "equals": "value"
}

  • Use la función field() para acceder al valor de una propiedad. Ejemplo:

    {
  "value": "[take(field('Microsoft.Test/resourceType/property'), 7)]",
  "equals": "prefix_"
}

La condición field tiene un comportamiento implícito de allOf. Si el alias representa una colección de valores, comprueba si todos los valores individuales cumplen la condición. La función field() devuelve los valores representados por el alias tal como están, que otras funciones de plantilla pueden manipular.

Referencia de campos de matriz

Las propiedades de recursos de matriz se representan mediante dos tipos diferentes de alias. Un alias normal y los alias de matriz que tienen [*] adjunto:

  • Microsoft.Test/resourceType/stringArray
  • Microsoft.Test/resourceType/stringArray[*]

Referencia a la matriz

El primer alias representa un valor único, el valor de la propiedad stringArray del contenido de la solicitud. Dado que el valor de esa propiedad es una matriz, no resulta útil en las condiciones de la directiva. Por ejemplo:

{
  "field": "Microsoft.Test/resourceType/stringArray",
  "equals": "..."
}

Esta condición compara toda la matriz stringArray con un valor de cadena único. La mayoría de las condiciones, incluida equals, solo aceptan valores de cadena, por lo que no se usa mucho en la comparación de una matriz con una cadena. El principal escenario en el que se hace referencia a la propiedad de matriz es útil cuando se comprueba si existe:

{
  "field": "Microsoft.Test/resourceType/stringArray",
  "exists": "true"
}

Con la función field(), el valor devuelto es la matriz del contenido de la solicitud, que se puede usar con cualquiera de las funciones de plantilla admitidas que aceptan argumentos de matriz. Por ejemplo, la siguiente condición comprueba si la longitud de stringArray es mayor que 0:

{
  "value": "[length(field('Microsoft.Test/resourceType/stringArray'))]",
  "greater": 0
}

Referencia a una colección de miembros de matriz

Los alias que usan la sintaxis [*] representan una colección de valores de propiedad seleccionados de una propiedad de matriz, que es diferente de seleccionar la propiedad de la matriz. Por ejemplo, Microsoft.Test/resourceType/stringArray[*] devuelve una colección que tiene todos los miembros de stringArray. Como se mencionó anteriormente, una condición field comprueba que todas las propiedades de recursos seleccionadas cumplan la condición; por lo tanto, la siguiente condición solo es verdadera si todos los miembros de stringArray son iguales a "value".

{
  "field": "Microsoft.Test/resourceType/stringArray[*]",
  "equals": "value"
}

Si la matriz está vacía, la condición se evaluará como true porque no hay ningún miembro de la matriz en infracción. En este escenario, la recomendación es usar la expresión count en su lugar. Si la matriz contiene objetos, se puede usar un alias [*] para seleccionar el valor de una propiedad específica de cada miembro de la matriz. Ejemplo:

{
  "field": "Microsoft.Test/resourceType/objectArray[*].property",
  "equals": "value"
}

Esta condición es true si los valores de todas las propiedades property en objectArray son iguales que "value". Para obtener más ejemplos, consulte Más ejemplos de alias.

Cuando use la función field() para hacer referencia a un alias de matriz, el valor devuelto es una matriz de todos los valores seleccionados. Este comportamiento implica que el caso de uso común de la función field(), la capacidad de aplicar funciones de plantilla a los valores de propiedad de los recursos, es limitado. Las únicas funciones de plantilla que se pueden usar en este caso son las que aceptan argumentos de matriz. Por ejemplo, se puede obtener la longitud de la matriz con [length(field('Microsoft.Test/resourceType/objectArray[*].property'))]. Sin embargo, los escenarios más complejos, como la aplicación de una función de plantilla a cada miembro de la matriz y su comparación con un valor deseado, solo son posibles cuando se usa la expresión count. Para obtener más información, vea Expresiones de recuento de campos.

En resumen, consulte el contenido de recurso del siguiente ejemplo y los valores seleccionados que devolvieron diversos alias:

{
  "tags": {
    "env": "prod"
  },
  "properties": {
    "stringArray": [
      "a",
      "b",
      "c"
    ],
    "objectArray": [
      {
        "property": "value1",
        "nestedArray": [
          1,
          2
        ]
      },
      {
        "property": "value2",
        "nestedArray": [
          3,
          4
        ]
      }
    ]
  }
}

Al usar la condición field en el contenido de recurso del ejemplo, los resultados son los siguientes:

Alias Valores seleccionados
Microsoft.Test/resourceType/missingArray null
Microsoft.Test/resourceType/missingArray[*] Colección de valores vacía.
Microsoft.Test/resourceType/missingArray[*].property Colección de valores vacía.
Microsoft.Test/resourceType/stringArray ["a", "b", "c"]
Microsoft.Test/resourceType/stringArray[*] "a", "b", "c"
Microsoft.Test/resourceType/objectArray[*] { "property": "value1", "nestedArray": [ 1, 2 ] },
{ "property": "value2", "nestedArray": [ 3, 4 ] }
Microsoft.Test/resourceType/objectArray[*].property "value1", "value2"
Microsoft.Test/resourceType/objectArray[*].nestedArray [ 1, 2 ], [ 3, 4 ]
Microsoft.Test/resourceType/objectArray[*].nestedArray[*] 1, 2, 3, 4

Al usar la función field() en el contenido de recurso del ejemplo, los resultados son los siguientes:

Expression Valor devuelto
[field('Microsoft.Test/resourceType/missingArray')] ""
[field('Microsoft.Test/resourceType/missingArray[*]')] []
[field('Microsoft.Test/resourceType/missingArray[*].property')] []
[field('Microsoft.Test/resourceType/stringArray')] ["a", "b", "c"]
[field('Microsoft.Test/resourceType/stringArray[*]')] ["a", "b", "c"]
[field('Microsoft.Test/resourceType/objectArray[*]')] [{ "property": "value1", "nestedArray": [ 1, 2 ] }, { "property": "value2", "nestedArray": [ 3, 4 ] }]
[field('Microsoft.Test/resourceType/objectArray[*].property')] ["value1", "value2"]
[field('Microsoft.Test/resourceType/objectArray[*].nestedArray')] [[ 1, 2 ], [ 3, 4 ]]
[field('Microsoft.Test/resourceType/objectArray[*].nestedArray[*]')] [1, 2, 3, 4]

Expresiones de recuento de campos

Las expresiones field count cuentan el número de miembros de la matriz que cumplen una condición y comparan el recuento con un valor de destino. La expresión Count es más intuitiva y versátil para evaluar las matrices que las condiciones field. La sintaxis es:

{
  "count": {
    "field": <[*
    ] alias>,
    "where": <optional policy condition expression>
  },
  "equals|greater|less|any other operator": <target value>
}

Cuando se usa sin una condición where, count simplemente devuelve la longitud de una matriz. Con el contenido de recurso del ejemplo de la sección anterior, la siguiente expresión count se evalúa como true, porque stringArray tiene tres miembros:

{
  "count": {
    "field": "Microsoft.Test/resourceType/stringArray[*]"
  },
  "equals": 3
}

Este comportamiento también funciona con matrices anidadas. Por ejemplo, la siguiente expresión count se evalúa como true, ya que hay cuatro miembros de matriz en las matrices nestedArray:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]"
  },
  "greaterOrEquals": 4
}

La eficacia de count reside en la condición where. Cuando se especifica count, Azure Policy enumera los miembros de la matriz y los evalúa con la condición, de modo que cuenta el número de miembros de la matriz que se han evaluado como true. En concreto, en cada iteración de la evaluación de la condición where, Azure Policy selecciona un único miembro i de la matriz y evalúa el contenido del recurso con la condición where como si i fuera el único miembro de la matriz. Disponer de un solo miembro de la matriz en cada iteración proporciona una manera de aplicar condiciones complejas en cada miembro de la matriz individual.

Ejemplo:

{
  "count": {
    "field": "Microsoft.Test/resourceType/stringArray[*]",
    "where": {
      "field": "Microsoft.Test/resourceType/stringArray[*]",
      "equals": "a"
    }
  },
  "equals": 1
}

Para evaluar la expresión count, Azure Policy evalúa la condición where tres veces, una vez por cada miembro de stringArray, de modo que cuenta el número de veces que se ha evaluado como true. Cuando la condición where hace referencia a los miembros de la matriz Microsoft.Test/resourceType/stringArray[*], en lugar de seleccionar todos los miembros de stringArray, selecciona cada vez un único miembro de la matriz:

Iteración Valores seleccionados de Microsoft.Test/resourceType/stringArray[*] Resultado de la evaluación de where
1 "a" true
2 "b" false
3 "c" false

count devuelve 1.

La siguiente es una expresión más compleja:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*]",
    "where": {
      "allOf": [
        {
          "field": "Microsoft.Test/resourceType/objectArray[*].property",
          "equals": "value2"
        },
        {
          "field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
          "greater": 2
        }
      ]
    }
  },
  "equals": 1
}
Iteración Valores seleccionados Resultado de la evaluación de where
1 Microsoft.Test/resourceType/objectArray[*].property =>"value1"
Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2		 false
2 Microsoft.Test/resourceType/objectArray[*].property =>"value2"
Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4		 true

count devuelve 1.

El hecho de que la expresión where se evalúe con todo el contenido de la solicitud (con cambios solo en el miembro de la matriz que se está enumerando actualmente) implica que la condición where también puede hacer referencia a los campos que se encuentran fuera de la matriz:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*]",
    "where": {
      "field": "tags.env",
      "equals": "prod"
    }
  },
  "equals": 0
}
Iteración Valores seleccionados Resultado de la evaluación de where
1 tags.env =>"prod" true
2 tags.env =>"prod" true

Las expresiones de recuento anidadas se pueden usar para aplicar condiciones a los campos de matriz anidados. Por ejemplo, la siguiente condición comprueba que la matriz objectArray[*] tiene exactamente 2 miembros con nestedArray[*] que contiene 1 o más miembros:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*]",
    "where": {
      "count": {
        "field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]"
      },
      "greaterOrEquals": 1
    }
  },
  "equals": 2
}
Iteración Valores seleccionados Resultado de evaluación de recuento anidado
1 Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2 nestedArray[*] tiene dos miembros =>true
2 Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4 nestedArray[*] tiene dos miembros =>true

Puesto que ambos miembros de objectArray[*] tienen una matriz secundaria nestedArray[*] con 2 miembros, la expresión de recuento exterior devuelve 2.

Ejemplo más complejo: compruebe que la matriz objectArray[*] tiene exactamente 2 miembros con nestedArray[*] con cualquier miembro igual a 2 o 3:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*]",
    "where": {
      "count": {
        "field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
        "where": {
          "field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
          "in": [
            2,
            3
          ]
        }
      },
      "greaterOrEquals": 1
    }
  },
  "equals": 2
}
Iteración Valores seleccionados Resultado de evaluación de recuento anidado
1 Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2 nestedArray[*] contiene 2 =>true
2 Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4 nestedArray[*] contiene 3 =>true

Dado que ambos miembros de objectArray[*] tienen una matriz secundaria nestedArray[*] que contiene 2 o 3, se devuelve la expresión de recuento exterior 2.

Nota

Las expresiones de recuento de campos anidados solo pueden hacer referencia a matrices anidadas. Por ejemplo, la expresión de recuento que hace referencia a Microsoft.Test/resourceType/objectArray[*] puede tener un recuento anidado que tenga como destino la matriz anidada Microsoft.Test/resourceType/objectArray[*].nestedArray[*], pero no puede tener una expresión de recuento anidada como destino Microsoft.Test/resourceType/stringArray[*].

Acceso al miembro de la matriz actual con funciones de plantilla

Si emplea funciones de plantilla, use la función current() para acceder al valor del miembro de la matriz actual o a los valores de cualquiera de sus propiedades. Para acceder al valor del miembro de la matriz actual, pase el alias definido en count.field o cualquiera de sus alias secundarios como argumento a la función current(). Por ejemplo:

{
  "count": {
    "field": "Microsoft.Test/resourceType/objectArray[*]",
    "where": {
      "value": "[current('Microsoft.Test/resourceType/objectArray[*].property')]",
      "like": "value*"
    }
  },
  "equals": 2
}
Iteración Valor devuelto por current() Resultado de la evaluación de where
1 Valor de property en el primer miembro de objectArray[*]: value1 true
2 Valor de property en el primer miembro de objectArray[*]: value2 true

Función field dentro de condiciones where

La función field() también se puede usar para acceder al valor del miembro de la matriz actual siempre que la expresión count no esté dentro de una condición de existencia (la función field() siempre hace referencia al recurso evaluado en la condición if). El comportamiento de field() cuando hace referencia a la matriz evaluada se basa en los siguientes conceptos:

  • Los alias de matriz se resuelven en una colección de valores seleccionados a partir de todos los miembros de la matriz.
  • Las funciones field() que hacen referencia a alias de matriz devuelven una matriz con los valores seleccionados.
  • Al hacer referencia al alias de matriz que se contó dentro de la condición where, se devuelve una colección con un solo valor seleccionado en el miembro de la matriz, que se evalúa en la iteración actual.

Este comportamiento implica que cuando se hace referencia al miembro de matriz contado con una función field() dentro de la condición where, se devuelve una matriz con un solo miembro. Aunque este comportamiento puede no ser intuitivo, es coherente con la idea de que los alias de matriz siempre devuelven una colección de propiedades seleccionadas. Este es un ejemplo:

{
  "count": {
    "field": "Microsoft.Test/resourceType/stringArray[*]",
    "where": {
      "field": "Microsoft.Test/resourceType/stringArray[*]",
      "equals": "[field('Microsoft.Test/resourceType/stringArray[*]')]"
    }
  },
  "equals": 0
}
Iteración Valores de expresión Resultado de la evaluación de where
1 Microsoft.Test/resourceType/stringArray[*] =>"a"
[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "a" ]		 false
2 Microsoft.Test/resourceType/stringArray[*] =>"b"
[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "b" ]		 false
3 Microsoft.Test/resourceType/stringArray[*] =>"c"
[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "c" ]		 false

Por lo tanto, cuando sea necesario acceder al valor del alias de matriz contado con una función field(), deberá encapsularlo con una función de plantilla first():

{
  "count": {
    "field": "Microsoft.Test/resourceType/stringArray[*]",
    "where": {
      "field": "Microsoft.Test/resourceType/stringArray[*]",
      "equals": "[first(field('Microsoft.Test/resourceType/stringArray[*]'))]"
    }
  }
}
Iteración Valores de expresión Resultado de la evaluación de where
1 Microsoft.Test/resourceType/stringArray[*] =>"a"
[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"a"		 true
2 Microsoft.Test/resourceType/stringArray[*] =>"b"
[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"b"		 true
3 Microsoft.Test/resourceType/stringArray[*] =>"c"
[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"c"		 true

Para obtener ejemplos útiles, vea Ejemplos de field count.

Modificación de matrices

append y modify alteran las propiedades de un recurso durante la creación o la actualización. Cuando se trabaja con propiedades de matriz, el comportamiento de estos efectos depende de si la operación intenta modificar el alias [*] o no:

Nota:

El uso del efecto modify con alias está actualmente en versión preliminar.

Alias Efecto Resultado
Microsoft.Storage/storageAccounts/networkAcls.ipRules append Azure Policy anexa toda la matriz especificada en los detalles del efecto, si falta.
Microsoft.Storage/storageAccounts/networkAcls.ipRules modify con la operación add Azure Policy anexa toda la matriz especificada en los detalles del efecto, si falta.
Microsoft.Storage/storageAccounts/networkAcls.ipRules modify con la operación addOrReplace Azure Policy anexa toda la matriz especificada en los detalles del efecto, si falta, o reemplaza la matriz existente.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] append Azure Policy anexa el miembro de la matriz especificado en los detalles del efecto.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] modify con la operación add Azure Policy anexa el miembro de la matriz especificado en los detalles del efecto.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] modify con la operación addOrReplace Azure Policy quita todos los miembros de la matriz existentes y anexa el miembro de la matriz especificado en los detalles del efecto.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action append Azure Policy anexa un valor a la propiedad action de cada miembro de la matriz.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action modify con la operación add Azure Policy anexa un valor a la propiedad action de cada miembro de la matriz.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action modify con la operación addOrReplace Azure Policy anexa o reemplaza la propiedad action existente de cada miembro de la matriz.

Para obtener más información, consulte Ejemplos de append.

Más ejemplos de alias

Se recomienda usar las expresiones field count para comprobar si allOf o anyOf de los miembros de una matriz del contenido de la solicitud cumplen una condición. En algunas condiciones sencillas, es posible obtener el mismo resultado mediante un descriptor de acceso de campo con un alias de matriz, como se describe en Referencia a una colección de miembros de matriz. Este modelo puede ser útil en reglas de directiva que superan el límite de expresiones count permitidas. Estos son algunos ejemplos de casos de uso comunes:

Regla de directiva de ejemplo para la tabla de escenario siguiente:

"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules",
        "exists": "true"
      },
            <-- Condition (see table below) -->
    ]
  },
  "then": {
    "effect": "[parameters('effectType')]"
  }
}

La matriz ipRules es la siguiente para la tabla de escenario siguiente:

"ipRules": [
  {
    "value": "127.0.0.1",
    "action": "Allow"
  },
  {
    "value": "192.168.1.1",
    "action": "Allow"
  }
]

Para cada uno de los ejemplos de condición siguientes, reemplace <field> por "field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].value".

Los siguientes resultados se derivan de la combinación de la condición y la regla de directiva de ejemplo y la matriz de valores existentes anteriores:

Condición Resultado Escenario Explicación
{<field>,"notEquals":"127.0.0.1"} Nada Ninguna coincidencia Un elemento de matriz se evalúa como false (127.0.0.1 != 127.0.0.1) y uno como true (127.0.0.1 != 192.168.1.1), por lo que la condición notEquals es false y el efecto no se desencadena.
{<field>,"notEquals":"10.0.4.1"} Efecto de la directiva Ninguna coincidencia Ambos elementos de matriz se evalúan como true (10.0.4.1 != 127.0.0.1 and 10.0.4.1 != 192.168.1.1), por lo que la condición notEquals es true y el efecto se desencadena.
"not":{<field>,"notEquals":"127.0.0.1" } Efecto de la directiva Una o más coincidencias Un elemento de matriz se evalúa como false (127.0.0.1 != 127.0.0.1) y uno como true (127.0.0.1 != 192.168.1.1), por lo que la condición notEquals es false. El operador lógico se evalúa como true (no false), por lo que el efecto se desencadena.
"not":{<field>,"notEquals":"10.0.4.1"} Nada Una o más coincidencias Ambos elementos de matriz se evalúan como true (10.0.4.1 != 127.0.0.1 and 10.0.4.1 != 192.168.1.1), por lo que la condición notEquals es true. El operador lógico se evalúa como false (no true), por lo que no se desencadena el efecto.
"not":{<field>,"Equals":"127.0.0.1"} Efecto de la directiva Coincidencia parcial Un elemento de matriz se evalúa como true (127.0.0.1 == 127.0.0.1) y uno como false (127.0.0.1 == 192.168.1.1), por lo que la condición Equals es false. El operador lógico se evalúa como true (no false), por lo que el efecto se desencadena.
"not":{<field>,"Equals":"10.0.4.1"} Efecto de la directiva Coincidencia parcial Ambos elementos de matriz se evalúan como false (10.0.4.1 == 127.0.0.1 and 10.0.4.1 == 192.168.1.1), por lo que la condición Equals es false. El operador lógico se evalúa como true (no false), por lo que el efecto se desencadena.
{<field>,"Equals":"127.0.0.1"} Nada Coincidencia total Un elemento de matriz se evalúa como true (127.0.0.1 == 127.0.0.1) y uno como false (127.0.0.1 == 192.168.1.1), por lo que la condición Equals es false y el efecto no se desencadena.
{<field>,"Equals":"10.0.4.1"} Nada Coincidencia total Ambos elementos de matriz se evalúan como false (10.0.4.1 == 127.0.0.1 and 10.0.4.1 == 192.168.1.1), por lo que la condición Equals es false y el efecto no se desencadena.

Pasos siguientes