Compartir a través de

Microsoft.Authorization policySetDefinitions/versions 2024-05-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso policySetDefinitions/versions se puede implementar con operaciones que tienen como destino:

  • de inquilinos: consulte comandos de implementación de inquilinos * grupos de administración: consulte comandos de implementación de grupos de administración de * de suscripción: consulte comandos de implementación de suscripciones

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Authorization/policySetDefinitions/versions, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Authorization/policySetDefinitions/versions@2024-05-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    metadata: any(Azure.Bicep.Types.Concrete.AnyType)
    parameters: {
      {customized property}: {
        allowedValues: [
          any(Azure.Bicep.Types.Concrete.AnyType)
        ]
        defaultValue: any(Azure.Bicep.Types.Concrete.AnyType)
        metadata: {
          assignPermissions: bool
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        schema: any(Azure.Bicep.Types.Concrete.AnyType)
        type: 'string'
      }
    }
    policyDefinitionGroups: [
      {
        additionalMetadataId: 'string'
        category: 'string'
        description: 'string'
        displayName: 'string'
        name: 'string'
      }
    ]
    policyDefinitions: [
      {
        definitionVersion: 'string'
        groupNames: [
          'string'
        ]
        parameters: {
          {customized property}: {
            value: any(Azure.Bicep.Types.Concrete.AnyType)
          }
        }
        policyDefinitionId: 'string'
        policyDefinitionReferenceId: 'string'
      }
    ]
    policyType: 'string'
    version: 'string'
  }
}

Valores de propiedad

Microsoft.Authorization/policySetDefinitions/versions

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+$ (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: policySetDefinitions
Propiedades Propiedades de la versión de definición del conjunto de directivas. policySetDefinitionVersionProperties

ParameterDefinitions

Nombre Descripción Valor

ParameterDefinitionsValue

Nombre Descripción Valor
allowedValues Valores permitidos para el parámetro . any[]
defaultValue Valor predeterminado del parámetro si no se proporciona ningún valor. cualquier
metadatos Metadatos generales para el parámetro . ParameterDefinitionsValueMetadata
esquema Proporciona validación de entradas de parámetro durante la asignación mediante un esquema JSON autodefinido. Esta propiedad solo se admite para los parámetros de tipo de objeto y sigue la implementación del esquema de Json.NET 2019-09. Puede obtener más información sobre el uso de esquemas en https://json-schema.org/ y probar esquemas de borrador en https://www.jsonschemavalidator.net/. cualquier
tipo Tipo de datos del parámetro. 'Matriz'
'Boolean'
'DateTime'
'Float'
'Entero'
'Object'
'String'

ParameterDefinitionsValueMetadata

Nombre Descripción Valor
assignPermissions Establézcalo en true para que Azure Portal cree asignaciones de roles en el identificador de recurso o el valor de ámbito de recurso de este parámetro durante la asignación de directivas. Esta propiedad es útil en caso de que desee asignar permisos fuera del ámbito de asignación. Bool
descripción Descripción del parámetro . cuerda
displayName Nombre para mostrar del parámetro. cuerda
strongType Se usa al asignar la definición de directiva a través del portal. Proporciona una lista con reconocimiento de contexto de valores entre los que el usuario puede elegir. cuerda

ParameterValues

Nombre Descripción Valor

ParameterValuesValue

Nombre Descripción Valor
valor Valor del parámetro . cualquier

PolicyDefinitionGroup

Nombre Descripción Valor
additionalMetadataId Identificador de recurso de un recurso que contiene metadatos adicionales sobre el grupo. cuerda
categoría Categoría del grupo. cuerda
descripción Descripción del grupo. cuerda
displayName Nombre para mostrar del grupo. cuerda
nombre Nombre del grupo. string (obligatorio)

PolicyDefinitionReference

Nombre Descripción Valor
definitionVersion Versión de la definición de directiva que se va a usar. cuerda
groupNames Nombre de los grupos a los que pertenece esta referencia de definición de directiva. string[]
Parámetros Valores de parámetro para la regla de directiva a la que se hace referencia. Las claves son los nombres de parámetro. ParameterValues de
policyDefinitionId Identificador de la definición de directiva o definición del conjunto de directivas. string (obligatorio)
policyDefinitionReferenceId Identificador único (dentro de la definición del conjunto de directivas) para esta referencia de definición de directiva. cuerda

PolicySetDefinitionVersionProperties

Nombre Descripción Valor
descripción Descripción de la definición del conjunto de directivas. cuerda
displayName Nombre para mostrar de la definición del conjunto de directivas. cuerda
metadatos Metadatos de definición del conjunto de directivas. Los metadatos son un objeto terminado abierto y normalmente es una colección de pares clave-valor. cualquier
Parámetros Los parámetros de definición del conjunto de directivas que se pueden usar en las referencias de definición de directiva. ParameterDefinitions
policyDefinitionGroups Metadatos que describen grupos de referencias de definición de directiva dentro de la definición del conjunto de directivas. PolicyDefinitionGroup[]
policyDefinitions Matriz de referencias de definición de directiva. PolicyDefinitionReference[] (obligatorio)
policyType Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static. 'BuiltIn'
'Personalizado'
'NotSpecified'
'Static'
Versión La versión de definición del conjunto de directivas en formato #.#.# cuerda

Definición de recursos de plantilla de ARM

El tipo de recurso policySetDefinitions/versions se puede implementar con operaciones que tienen como destino:

  • de inquilinos: consulte comandos de implementación de inquilinos * grupos de administración: consulte comandos de implementación de grupos de administración de * de suscripción: consulte comandos de implementación de suscripciones

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Authorization/policySetDefinitions/versions, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Authorization/policySetDefinitions/versions",
  "apiVersion": "2024-05-01",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "metadata": {},
    "parameters": {
      "{customized property}": {
        "allowedValues": [ {} ],
        "defaultValue": {},
        "metadata": {
          "assignPermissions": "bool",
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "schema": {},
        "type": "string"
      }
    },
    "policyDefinitionGroups": [
      {
        "additionalMetadataId": "string",
        "category": "string",
        "description": "string",
        "displayName": "string",
        "name": "string"
      }
    ],
    "policyDefinitions": [
      {
        "definitionVersion": "string",
        "groupNames": [ "string" ],
        "parameters": {
          "{customized property}": {
            "value": {}
          }
        },
        "policyDefinitionId": "string",
        "policyDefinitionReferenceId": "string"
      }
    ],
    "policyType": "string",
    "version": "string"
  }
}

Valores de propiedad

Microsoft.Authorization/policySetDefinitions/versions

Nombre Descripción Valor
apiVersion La versión de api '2024-05-01'
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+$ (obligatorio)
Propiedades Propiedades de la versión de definición del conjunto de directivas. policySetDefinitionVersionProperties
tipo El tipo de recurso 'Microsoft.Authorization/policySetDefinitions/versions'

ParameterDefinitions

Nombre Descripción Valor

ParameterDefinitionsValue

Nombre Descripción Valor
allowedValues Valores permitidos para el parámetro . any[]
defaultValue Valor predeterminado del parámetro si no se proporciona ningún valor. cualquier
metadatos Metadatos generales para el parámetro . ParameterDefinitionsValueMetadata
esquema Proporciona validación de entradas de parámetro durante la asignación mediante un esquema JSON autodefinido. Esta propiedad solo se admite para los parámetros de tipo de objeto y sigue la implementación del esquema de Json.NET 2019-09. Puede obtener más información sobre el uso de esquemas en https://json-schema.org/ y probar esquemas de borrador en https://www.jsonschemavalidator.net/. cualquier
tipo Tipo de datos del parámetro. 'Matriz'
'Boolean'
'DateTime'
'Float'
'Entero'
'Object'
'String'

ParameterDefinitionsValueMetadata

Nombre Descripción Valor
assignPermissions Establézcalo en true para que Azure Portal cree asignaciones de roles en el identificador de recurso o el valor de ámbito de recurso de este parámetro durante la asignación de directivas. Esta propiedad es útil en caso de que desee asignar permisos fuera del ámbito de asignación. Bool
descripción Descripción del parámetro . cuerda
displayName Nombre para mostrar del parámetro. cuerda
strongType Se usa al asignar la definición de directiva a través del portal. Proporciona una lista con reconocimiento de contexto de valores entre los que el usuario puede elegir. cuerda

ParameterValues

Nombre Descripción Valor

ParameterValuesValue

Nombre Descripción Valor
valor Valor del parámetro . cualquier

PolicyDefinitionGroup

Nombre Descripción Valor
additionalMetadataId Identificador de recurso de un recurso que contiene metadatos adicionales sobre el grupo. cuerda
categoría Categoría del grupo. cuerda
descripción Descripción del grupo. cuerda
displayName Nombre para mostrar del grupo. cuerda
nombre Nombre del grupo. string (obligatorio)

PolicyDefinitionReference

Nombre Descripción Valor
definitionVersion Versión de la definición de directiva que se va a usar. cuerda
groupNames Nombre de los grupos a los que pertenece esta referencia de definición de directiva. string[]
Parámetros Valores de parámetro para la regla de directiva a la que se hace referencia. Las claves son los nombres de parámetro. ParameterValues de
policyDefinitionId Identificador de la definición de directiva o definición del conjunto de directivas. string (obligatorio)
policyDefinitionReferenceId Identificador único (dentro de la definición del conjunto de directivas) para esta referencia de definición de directiva. cuerda

PolicySetDefinitionVersionProperties

Nombre Descripción Valor
descripción Descripción de la definición del conjunto de directivas. cuerda
displayName Nombre para mostrar de la definición del conjunto de directivas. cuerda
metadatos Metadatos de definición del conjunto de directivas. Los metadatos son un objeto terminado abierto y normalmente es una colección de pares clave-valor. cualquier
Parámetros Los parámetros de definición del conjunto de directivas que se pueden usar en las referencias de definición de directiva. ParameterDefinitions
policyDefinitionGroups Metadatos que describen grupos de referencias de definición de directiva dentro de la definición del conjunto de directivas. PolicyDefinitionGroup[]
policyDefinitions Matriz de referencias de definición de directiva. PolicyDefinitionReference[] (obligatorio)
policyType Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static. 'BuiltIn'
'Personalizado'
'NotSpecified'
'Static'
Versión La versión de definición del conjunto de directivas en formato #.#.# cuerda

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso policySetDefinitions/versions se puede implementar con operaciones que tienen como destino:

  • grupos de administración dede inquilinos de de suscripción

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Authorization/policySetDefinitions/versions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policySetDefinitions/versions@2024-05-01"
  name = "string"
  body = jsonencode({
    properties = {
      description = "string"
      displayName = "string"
      metadata = ?
      parameters = {
        {customized property} = {
          allowedValues = [
            ?
          ]
          defaultValue = ?
          metadata = {
            assignPermissions = bool
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          schema = ?
          type = "string"
        }
      }
      policyDefinitionGroups = [
        {
          additionalMetadataId = "string"
          category = "string"
          description = "string"
          displayName = "string"
          name = "string"
        }
      ]
      policyDefinitions = [
        {
          definitionVersion = "string"
          groupNames = [
            "string"
          ]
          parameters = {
            {customized property} = {
              value = ?
            }
          }
          policyDefinitionId = "string"
          policyDefinitionReferenceId = "string"
        }
      ]
      policyType = "string"
      version = "string"
    }
  })
}

Valores de propiedad

Microsoft.Authorization/policySetDefinitions/versions

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: policySetDefinitions
Propiedades Propiedades de la versión de definición del conjunto de directivas. policySetDefinitionVersionProperties
tipo El tipo de recurso "Microsoft.Authorization/policySetDefinitions/versions@2024-05-01"

ParameterDefinitions

Nombre Descripción Valor

ParameterDefinitionsValue

Nombre Descripción Valor
allowedValues Valores permitidos para el parámetro . any[]
defaultValue Valor predeterminado del parámetro si no se proporciona ningún valor. cualquier
metadatos Metadatos generales para el parámetro . ParameterDefinitionsValueMetadata
esquema Proporciona validación de entradas de parámetro durante la asignación mediante un esquema JSON autodefinido. Esta propiedad solo se admite para los parámetros de tipo de objeto y sigue la implementación del esquema de Json.NET 2019-09. Puede obtener más información sobre el uso de esquemas en https://json-schema.org/ y probar esquemas de borrador en https://www.jsonschemavalidator.net/. cualquier
tipo Tipo de datos del parámetro. 'Matriz'
'Boolean'
'DateTime'
'Float'
'Entero'
'Object'
'String'

ParameterDefinitionsValueMetadata

Nombre Descripción Valor
assignPermissions Establézcalo en true para que Azure Portal cree asignaciones de roles en el identificador de recurso o el valor de ámbito de recurso de este parámetro durante la asignación de directivas. Esta propiedad es útil en caso de que desee asignar permisos fuera del ámbito de asignación. Bool
descripción Descripción del parámetro . cuerda
displayName Nombre para mostrar del parámetro. cuerda
strongType Se usa al asignar la definición de directiva a través del portal. Proporciona una lista con reconocimiento de contexto de valores entre los que el usuario puede elegir. cuerda

ParameterValues

Nombre Descripción Valor

ParameterValuesValue

Nombre Descripción Valor
valor Valor del parámetro . cualquier

PolicyDefinitionGroup

Nombre Descripción Valor
additionalMetadataId Identificador de recurso de un recurso que contiene metadatos adicionales sobre el grupo. cuerda
categoría Categoría del grupo. cuerda
descripción Descripción del grupo. cuerda
displayName Nombre para mostrar del grupo. cuerda
nombre Nombre del grupo. string (obligatorio)

PolicyDefinitionReference

Nombre Descripción Valor
definitionVersion Versión de la definición de directiva que se va a usar. cuerda
groupNames Nombre de los grupos a los que pertenece esta referencia de definición de directiva. string[]
Parámetros Valores de parámetro para la regla de directiva a la que se hace referencia. Las claves son los nombres de parámetro. ParameterValues de
policyDefinitionId Identificador de la definición de directiva o definición del conjunto de directivas. string (obligatorio)
policyDefinitionReferenceId Identificador único (dentro de la definición del conjunto de directivas) para esta referencia de definición de directiva. cuerda

PolicySetDefinitionVersionProperties

Nombre Descripción Valor
descripción Descripción de la definición del conjunto de directivas. cuerda
displayName Nombre para mostrar de la definición del conjunto de directivas. cuerda
metadatos Metadatos de definición del conjunto de directivas. Los metadatos son un objeto terminado abierto y normalmente es una colección de pares clave-valor. cualquier
Parámetros Los parámetros de definición del conjunto de directivas que se pueden usar en las referencias de definición de directiva. ParameterDefinitions
policyDefinitionGroups Metadatos que describen grupos de referencias de definición de directiva dentro de la definición del conjunto de directivas. PolicyDefinitionGroup[]
policyDefinitions Matriz de referencias de definición de directiva. PolicyDefinitionReference[] (obligatorio)
policyType Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static. 'BuiltIn'
'Personalizado'
'NotSpecified'
'Static'
Versión La versión de definición del conjunto de directivas en formato #.#.# cuerda