Policy Set Definition Versions - Create Or Update

Servicio:: Policy

Versión de la API:: 2025-11-01

Esta operación crea o actualiza una versión de definición del conjunto de políticas en la suscripción dada con el nombre y la versión.

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}?api-version=2025-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
policyDefinitionVersion	path	True	string pattern: ^\d+\.\d+\.\d+$	Versión de definición del conjunto de directivas. El formato es x.y.z donde x es el número de versión principal, y el número de versión menor y z el número de parche
policySetDefinitionName	path	True	string pattern: ^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$	Nombre de la definición del conjunto de directivas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.policyDefinitions	True	PolicyDefinitionReference[]	Matriz de referencias de definición de directiva.
properties.description		string	Descripción de la definición del conjunto de directivas.
properties.displayName		string	Nombre para mostrar de la definición del conjunto de directivas.
properties.metadata			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.
properties.parameters		<string, ParameterDefinitionsValue>	Los parámetros de definición del conjunto de directivas que se pueden usar en las referencias de definición de directiva.
properties.policyDefinitionGroups		PolicyDefinitionGroup[]	Metadatos que describen grupos de referencias de definición de directiva dentro de la definición del conjunto de directivas.
properties.policyType		PolicyType	Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static.
properties.version		string	La versión de definición del conjunto de directivas en formato #.#.#

Respuestas

Nombre	Tipo	Description
200 OK	PolicySetDefinitionVersion	Operación de actualización 'PolicySetDefinitionVersion' de recurso exitosa
201 Created	PolicySetDefinitionVersion	Recurso 'PolicySetDefinitionVersion' crear operación exitosa
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Create or update a policy set definition version

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1?api-version=2025-11-01

{
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

Respuesta de muestra

status code:: 200

{
  "name": "1.2.1",
  "type": "Microsoft.Authorization/policySetDefinitions/versions",
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1",
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

status code:: 201

{
  "name": "1.2.1",
  "type": "Microsoft.Authorization/policySetDefinitions/versions",
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1",
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ParameterDefinitionsValue	La definición de un parámetro que puede proporcionarse a la póliza.
ParameterDefinitionsValueMetadata	Metadatos generales para el parámetro .
ParameterType	Tipo de datos del parámetro.
ParameterValuesValue	El valor de un parámetro.
PolicyDefinitionGroup	El grupo de definición de políticas.
PolicyDefinitionReference	La referencia de definición de póliza.
PolicySetDefinitionVersion	Versión de definición del conjunto de directivas.
PolicyType	Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static.
systemData	Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ParameterDefinitionsValue

Objeto

La definición de un parámetro que puede proporcionarse a la póliza.

Nombre	Tipo	Description
allowedValues	AllowedValues[]	Valores permitidos para el parámetro .
defaultValue		Valor predeterminado del parámetro si no se proporciona ningún valor.
metadata	ParameterDefinitionsValueMetadata	Metadatos generales para el parámetro .
schema		Proporciona validación de entradas de parámetro durante la asignación mediante un esquema JSON autodefinido. Esta propiedad solo es compatible con parámetros de tipo objeto y sigue la implementación del Esquema Json.NET 2019-09. Puedes aprender más sobre el uso de esquemas en https://json-schema.org/ y borradores de prueba en https://www.jsonschemavalidator.net/.
type	ParameterType	Tipo de datos del parámetro.

ParameterDefinitionsValueMetadata

Objeto

Metadatos generales para el parámetro .

Nombre	Tipo	Description
assignPermissions	boolean	Configura en true para que el portal Azure genere asignaciones de roles sobre el ID de recurso o el valor del alcance de este parámetro durante la asignación de políticas. Esta propiedad es útil en caso de que desee asignar permisos fuera del ámbito de asignación.
description	string	Descripción del parámetro .
displayName	string	Nombre para mostrar del parámetro.
strongType	string	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.

ParameterType

Enumeración

Tipo de datos del parámetro.

Valor	Description
String	El tipo de parámetro de cadena.
Array	El tipo de parámetro del array.
Object	El tipo de parámetro del objeto.
Boolean	El tipo de parámetro booleano.
Integer	El tipo de parámetro entero.
Float	El tipo de parámetro flotante.
DateTime	El tipo de parámetro fecha-hora.

ParameterValuesValue

Objeto

El valor de un parámetro.

Nombre	Tipo	Description
value		Valor del parámetro .

PolicyDefinitionGroup

Objeto

El grupo de definición de políticas.

Nombre	Tipo	Description
additionalMetadataId	string	Identificador de recurso de un recurso que contiene metadatos adicionales sobre el grupo.
category	string	Categoría del grupo.
description	string	Descripción del grupo.
displayName	string	Nombre para mostrar del grupo.
name	string	Nombre del grupo.

PolicyDefinitionReference

Objeto

La referencia de definición de póliza.

Nombre	Tipo	Description
definitionVersion	string	Versión de la definición de directiva que se va a usar.
effectiveDefinitionVersion	string	La versión efectiva de la definición de política en uso. Esto solo está presente si se solicita a través del parámetro de consulta $expand.
groupNames	string[]	Nombre de los grupos a los que pertenece esta referencia de definición de directiva.
latestDefinitionVersion	string	La última versión de la definición de la póliza disponible. Esto solo está presente si se solicita a través del parámetro de consulta $expand.
parameters	<string, ParameterValuesValue>	Valores de parámetro para la regla de directiva a la que se hace referencia. Las claves son los nombres de parámetro.
policyDefinitionId	string	Identificador de la definición de directiva o definición del conjunto de directivas.
policyDefinitionReferenceId	string	Identificador único (dentro de la definición del conjunto de directivas) para esta referencia de definición de directiva.