Policy Set Definition Versions - List All Builtins
Uvádí všechny vestavěné verze definic sady politik.
Tato operace uvádí všechny verze vestavěných definic sady politik pro všechny vestavěné definice sad politik.
POST https://management.azure.com/providers/Microsoft.Authorization/listPolicySetDefinitionVersions?api-version=2026-06-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Operace Azure byla úspěšně dokončena. |
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Tok OAuth2 služby Azure Active Directory.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| user_impersonation | vydávat se za svůj uživatelský účet |
Příklady
List all built-in policy definition versions
Ukázkový požadavek
POST https://management.azure.com/providers/Microsoft.Authorization/listPolicySetDefinitionVersions?api-version=2026-06-01
Ukázková odpověď
{
"value": [
{
"name": "1.2.1",
"type": "Microsoft.Authorization/policySetDefinitions/versions",
"id": "/providers/Microsoft.Authorization/policySetDefinitions/1f3afdf9-d0c9-4c3d-847f-89da613e70a8/versions/1.2.1",
"properties": {
"description": "Monitor all the available security recommendations in Azure Security Center. This is the default policy for Azure Security Center.",
"displayName": "[Preview]: Enable Monitoring in Azure Security Center",
"metadata": {
"category": "Security Center"
},
"parameters": {},
"policyDefinitions": [
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/a8bef009-a5c9-4d0f-90d7-6018734e8a16",
"policyDefinitionReferenceId": "RefId1"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/af8051bf-258b-44e2-a2bf-165330459f9d",
"policyDefinitionReferenceId": "RefId2"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/86b3d65f-7626-441e-b690-81a8b71cff60",
"policyDefinitionReferenceId": "RefId3"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/655cb504-bcee-4362-bd4c-402e6aa38759",
"policyDefinitionReferenceId": "RefId4"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/b0f33259-77d7-4c9e-aac6-3aabcfae693c",
"policyDefinitionReferenceId": "RefId5"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/47a6b606-51aa-4496-8bb7-64b11cf66adc",
"policyDefinitionReferenceId": "RefId6"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/44452482-524f-4bf4-b852-0bff7cc4a3ed",
"policyDefinitionReferenceId": "RefId7"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/e1e5fd5d-3e4c-4ce1-8661-7d1873ae6b15",
"policyDefinitionReferenceId": "RefId8"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/af6cd1bd-1635-48cb-bde7-5b15693900b9",
"policyDefinitionReferenceId": "RefId9"
},
{
"definitionVersion": "1.*.*",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/0961003e-5a0a-4549-abde-af6a37f2724d",
"policyDefinitionReferenceId": "RefId10"
}
],
"policyType": "BuiltIn",
"version": "1.2.1"
}
}
]
}
Definice
| Name | Description |
|---|---|
|
created |
Typ identity, která prostředek vytvořila. |
|
Error |
Další informace o chybě při správě prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
|
Parameter |
Definice parametru, který lze poskytnout zásadám. |
|
Parameter |
Obecná metadata parametru |
|
Parameter |
Datový typ parametru. |
|
Parameter |
Hodnota parametru. |
|
Policy |
Skupina definic zásad. |
|
Policy |
Referenční informace k definici zásad. |
|
Policy |
Verze definice sady zásad. |
|
Policy |
Odpověď operace seznamu PolicySetDefinitionVersion. |
|
Policy |
Typ definice zásady. Možné hodnoty jsou NotSpecified, BuiltIn, Custom a Static. |
|
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
createdByType
Typ identity, která prostředek vytvořila.
| Hodnota | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Další informace o chybě při správě prostředků
| Name | Typ | Description |
|---|---|---|
| info |
object |
Další informace. |
| type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
ParameterDefinitionsValue
Definice parametru, který lze poskytnout zásadám.
| Name | Typ | Description |
|---|---|---|
| allowedValues |
Allowed |
Povolené hodnoty parametru. |
| defaultValue |
Výchozí hodnota parametru, pokud není zadaná žádná hodnota. |
|
| metadata |
Obecná metadata parametru |
|
| schema |
Poskytuje ověřování vstupů parametrů během přiřazení pomocí schématu JSON definovaného vlastním kódem. Tato vlastnost je podporována pouze pro parametry typu objektu a odpovídá implementaci Json.NET Schema 2019-09. Další informace o použití schémat najdete na https://json-schema.org/ a koncepty schémat testujete na https://www.jsonschemavalidator.net/. |
|
| type |
Datový typ parametru. |
ParameterDefinitionsValueMetadata
Obecná metadata parametru
| Name | Typ | Description |
|---|---|---|
| assignPermissions |
boolean |
Nastavte na true, aby Azure portál vytvářel přiřazení rolí na ID zdroje nebo hodnotu rozsahu zdroje tohoto parametru během přiřazování politiky. Tato vlastnost je užitečná v případě, že chcete přiřadit oprávnění mimo obor přiřazení. |
| description |
string |
Popis parametru. |
| displayName |
string |
Zobrazovaný název parametru. |
| strongType |
string |
Používá se při přiřazování definice zásady prostřednictvím portálu. Poskytuje kontextový seznam hodnot, ze které si uživatel může vybrat. |
ParameterType
Datový typ parametru.
| Hodnota | Description |
|---|---|
| String |
Typ parametru řetězce. |
| Array |
Typ parametru pole. |
| Object |
Typ parametru objektu. |
| Boolean |
Booleovský typ parametru. |
| Integer |
Celočíselný typ parametru. |
| Float |
Typ parametru float. |
| DateTime |
Typ parametru date-time. |
ParameterValuesValue
Hodnota parametru.
| Name | Typ | Description |
|---|---|---|
| value |
Hodnota parametru. |
PolicyDefinitionGroup
Skupina definic zásad.
| Name | Typ | Description |
|---|---|---|
| additionalMetadataId |
string |
ID prostředku prostředku, který obsahuje další metadata o skupině. |
| category |
string |
Kategorie skupiny. |
| description |
string |
Popis skupiny. |
| displayName |
string |
Zobrazovaný název skupiny. |
| name |
string |
Název skupiny. |
PolicyDefinitionReference
Referenční informace k definici zásad.
| Name | Typ | Description |
|---|---|---|
| definitionVersion |
string |
Verze definice zásady, která se má použít. |
| effectiveDefinitionVersion |
string |
Efektivní verze používané definice pojistky. To je přítomno pouze v případě požadavku přes parametr $expand dotazu. |
| groupNames |
string[] |
Název skupin, do nichž patří tento odkaz na definici zásad. |
| latestDefinitionVersion |
string |
Nejnovější verze definice pojistky je dostupná. To je přítomno pouze v případě požadavku přes parametr $expand dotazu. |
| parameters |
<string,
Parameter |
Hodnoty parametrů pro odkazované pravidlo zásad. Klíče jsou názvy parametrů. |
| policyDefinitionId |
string |
ID definice zásady nebo definice sady zásad. |
| policyDefinitionReferenceId |
string |
Jedinečné ID (v definici sady zásad) pro tento odkaz na definici zásady. |
PolicySetDefinitionVersion
Verze definice sady zásad.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Název prostředku |
| properties.description |
string |
Popis definice sady zásad. |
| properties.displayName |
string |
Zobrazovaný název definice sady zásad. |
| properties.metadata |
Metadata definice sady zásad. Metadata jsou otevřený objekt, který je obvykle kolekcí párů klíč-hodnota. |
|
| properties.parameters |
<string,
Parameter |
Parametry definice sady zásad, které lze použít v odkazech na definici zásad. |
| properties.policyDefinitionGroups |
Metadata popisující skupiny odkazů na definice zásad v definici sady zásad. |
|
| properties.policyDefinitions |
Pole odkazů na definice zásad. |
|
| properties.policyType |
Typ definice zásady. Možné hodnoty jsou NotSpecified, BuiltIn, Custom a Static. |
|
| properties.version |
string |
Verze definice sady zásad ve formátu #.#.# |
| systemData |
Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil. |
|
| type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
PolicySetDefinitionVersionListResult
Odpověď operace seznamu PolicySetDefinitionVersion.
| Name | Typ | Description |
|---|---|---|
| nextLink |
string (uri) |
Odkaz na další stránku položek |
| value |
Položky PolicySetDefinitionVersion na této stránce |
PolicyType
Typ definice zásady. Možné hodnoty jsou NotSpecified, BuiltIn, Custom a Static.
| Hodnota | Description |
|---|---|
| NotSpecified |
Nespecifikovaný typ definice politiky. |
| BuiltIn |
Vestavěný typ definice politiky. |
| Custom |
Vlastní typ definice pojistky. |
| Static |
Statický typ definice politiky. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
string |
Identita, která prostředek vytvořila. |
| createdByType |
Typ identity, která prostředek vytvořila. |
|
| lastModifiedAt |
string (date-time) |
Časové razítko poslední změny zdroje (UTC) |
| lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
| lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |