Policy Set Definition Versions - Create Or Update

Service:

Policy

API-versie:

2025-11-01

Deze operatie creëert of werkt een versie van de beleidssetdefinitie bij in het betreffende abonnement met de voornaam en versie.

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

URI-parameters

Name	In	Vereist	Type	Description
policyDefinitionVersion	path	True	string pattern: ^\d+\.\d+\.\d+$	De definitieversie van de beleidsset. Het formaat is x.y.z waarbij x het hoofdversienummer is, y het kleine versienummer en z het patchnummer
policySetDefinitionName	path	True	string pattern: ^[^<>*%&:\?.+/]*[^<>*%&:\?.+/ ]+$	De naam van de definitie van de beleidsset.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
properties.policyDefinitions	True	PolicyDefinitionReference[]	Een matrix met beleidsdefinitieverwijzingen.
properties.description		string	De beschrijving van de definitie van de beleidsset.
properties.displayName		string	De weergavenaam van de definitie van de beleidsset.
properties.metadata			De metagegevens van de definitie van de beleidsset. Metagegevens zijn een geopend object en zijn meestal een verzameling sleutel-waardeparen.
properties.parameters		<string,  ParameterDefinitionsValue>	De parameters voor beleidssetdefinities die kunnen worden gebruikt in verwijzingen naar beleidsdefinities.
properties.policyDefinitionGroups		PolicyDefinitionGroup[]	De metagegevens die groepen beleidsdefinitieverwijzingen beschrijven binnen de beleidssetdefinitie.
properties.policyType		PolicyType	Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static.
properties.version		string	De definitieversie van de beleidsset in #.#.# -indeling.

Antwoorden

Name	Type	Description
200 OK	PolicySetDefinitionVersion	De updateoperatie van de bron 'PolicySetDefinitionVersion' is geslaagd
201 Created	PolicySetDefinitionVersion	Resource 'PolicySetDefinitionVersion' aanmaakoperatie geslaagd
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create or update a policy set definition version

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Statuscode:

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

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ParameterDefinitionsValue	De definitie van een parameter die aan het beleid kan worden gegeven.
ParameterDefinitionsValueMetadata	Algemene metagegevens voor de parameter.
ParameterType	Het gegevenstype van de parameter.
ParameterValuesValue	De waarde van een parameter.
PolicyDefinitionGroup	De beleidsdefinitiegroep.
PolicyDefinitionReference	De referentie van de beleidsdefinitie.
PolicySetDefinitionVersion	De definitieversie van de beleidsset.
PolicyType	Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ParameterDefinitionsValue

Object

De definitie van een parameter die aan het beleid kan worden gegeven.

Name	Type	Description
allowedValues	AllowedValues[]	De toegestane waarden voor de parameter.
defaultValue		De standaardwaarde voor de parameter als er geen waarde wordt opgegeven.
metadata	ParameterDefinitionsValueMetadata	Algemene metagegevens voor de parameter.
schema		Biedt validatie van parameterinvoer tijdens de toewijzing met behulp van een zelfgedefinieerde JSON-schema. Deze eigenschap wordt alleen ondersteund voor objecttypeparameters en volgt de implementatie van Json.NET Schema 2019-09. Je kunt meer leren over het gebruik van schema's op https://json-schema.org/ en conceptschema's testen op https://www.jsonschemavalidator.net/.
type	ParameterType	Het gegevenstype van de parameter.

ParameterDefinitionsValueMetadata

Object

Algemene metagegevens voor de parameter.

Name	Type	Description
assignPermissions	boolean	Zet op true zodat Azure portal roltoewijzingen maakt op de resource ID of resource scope-waarde van deze parameter tijdens beleidstoewijzing. Deze eigenschap is handig als u machtigingen wilt toewijzen buiten het toewijzingsbereik.
description	string	De beschrijving van de parameter.
displayName	string	De weergavenaam voor de parameter.
strongType	string	Wordt gebruikt bij het toewijzen van de beleidsdefinitie via de portal. Biedt een contextbewuste lijst met waarden waaruit de gebruiker kan kiezen.

ParameterType

Opsomming

Het gegevenstype van de parameter.

Waarde	Description
String	Het type stringparameter.
Array	Het type arrayparameter.
Object	Het type objectparameter.
Boolean	Het type booleaanse parameter.
Integer	Het gehele parametertype.
Float	Het type floatparameter.
DateTime	Het type datum-tijdparameter.

ParameterValuesValue

Object

De waarde van een parameter.

Name	Type	Description
value		De waarde van de parameter.

PolicyDefinitionGroup

Object

De beleidsdefinitiegroep.

Name	Type	Description
additionalMetadataId	string	Een resource-id van een resource die aanvullende metagegevens over de groep bevat.
category	string	De categorie van de groep.
description	string	De beschrijving van de groep.
displayName	string	De weergavenaam van de groep.
name	string	De naam van de groep.

PolicyDefinitionReference

Object

De referentie van de beleidsdefinitie.

Name	Type	Description
definitionVersion	string	De versie van de te gebruiken beleidsdefinitie.
effectiveDefinitionVersion	string	De effectieve versie van de gebruikte beleidsdefinitie. Dit is alleen aanwezig als het via de $expand queryparameter wordt aanvraagd.
groupNames	string[]	De naam van de groepen waartoe deze beleidsdefinitiereferentie behoort.
latestDefinitionVersion	string	De nieuwste versie van de beleidsdefinitie is beschikbaar. Dit is alleen aanwezig als het via de $expand queryparameter wordt aanvraagd.
parameters	<string,  ParameterValuesValue>	De parameterwaarden voor de beleidsregel waarnaar wordt verwezen. De sleutels zijn de parameternamen.
policyDefinitionId	string	De id van de beleidsdefinitie of beleidssetdefinitie.
policyDefinitionReferenceId	string	Een unieke id (binnen de definitie van de beleidsset) voor deze naslaginformatie over beleidsdefinities.

PolicySetDefinitionVersion

Object

De definitieversie van de beleidsset.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties.description	string	De beschrijving van de definitie van de beleidsset.
properties.displayName	string	De weergavenaam van de definitie van de beleidsset.
properties.metadata		De metagegevens van de definitie van de beleidsset. Metagegevens zijn een geopend object en zijn meestal een verzameling sleutel-waardeparen.
properties.parameters	<string,  ParameterDefinitionsValue>	De parameters voor beleidssetdefinities die kunnen worden gebruikt in verwijzingen naar beleidsdefinities.
properties.policyDefinitionGroups	PolicyDefinitionGroup[]	De metagegevens die groepen beleidsdefinitieverwijzingen beschrijven binnen de beleidssetdefinitie.
properties.policyDefinitions	PolicyDefinitionReference[]	Een matrix met beleidsdefinitieverwijzingen.
properties.policyType	PolicyType	Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static.
properties.version	string	De definitieversie van de beleidsset in #.#.# -indeling.
systemData	systemData	Azure Resource Manager metadata met creationBy en modifiedBy informatie.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

PolicyType

Opsomming

Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static.

Waarde	Description
NotSpecified	Het niet gespecificeerde type beleidsdefinitie.
BuiltIn	Het ingebouwde type polisdefinitie.
Custom	Het type aangepaste polisdefinitie.
Static	Het type statische beleidsdefinitie.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.