Policy Definition Versions - List All At Management Group
Listák a felügyeleti csoport hatókörében lévő összes szabályzatdefiníciós verziót.
Ez a művelet felsorolja a felügyeleti csoport hatókörében található összes szabályzatdefiníció összes szabályzatdefiníciójának verzióját.
POST https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/listPolicyDefinitionVersions?api-version=2023-04-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
management
|
path | True |
string |
A felügyeleti csoport neve. A név megkülönbözteti a kis- és nagybetűket. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK – A szabályzatdefiníciós verziók tömbjének visszaadása. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
List all policy definition versions at management group
Sample Request
Sample Response
{
"value": [
{
"id": "/providers/Microsoft.Management/managementgroups/MyManagementGroup/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming/versions/1.2.1",
"type": "Microsoft.Authorization/policyDefinitions/versions",
"name": "1.2.1",
"properties": {
"mode": "All",
"displayName": "Naming Convention",
"description": "Force resource names to begin with 'prefix' and end with 'suffix'",
"metadata": {
"category": "Naming"
},
"version": "1.2.1",
"policyRule": {
"if": {
"not": {
"field": "name",
"like": "[concat(parameters('prefix'), '*', parameters('suffix'))]"
}
},
"then": {
"effect": "deny"
}
},
"parameters": {
"prefix": {
"type": "String",
"metadata": {
"displayName": "Prefix",
"description": "Resource name prefix"
}
},
"suffix": {
"type": "String",
"metadata": {
"displayName": "Suffix",
"description": "Resource name suffix"
}
}
},
"policyType": "Custom"
}
},
{
"id": "/providers/Microsoft.Management/managementgroups/MyManagementGroup/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming/versions/1.0.0",
"type": "Microsoft.Authorization/policyDefinitions/versions",
"name": "1.0.0",
"properties": {
"mode": "All",
"displayName": "Naming Convention",
"description": "Force resource names to begin with 'prefix' and end with 'suffix'",
"metadata": {
"category": "Naming"
},
"version": "1.2.1",
"policyRule": {
"if": {
"not": {
"field": "name",
"like": "[concat(parameters('prefix'), '-*', parameters('suffix'))]"
}
},
"then": {
"effect": "deny"
}
},
"parameters": {
"prefix": {
"type": "String",
"metadata": {
"displayName": "Prefix",
"description": "Resource name prefix"
}
},
"suffix": {
"type": "String",
"metadata": {
"displayName": "Suffix",
"description": "Resource name suffix"
}
}
},
"policyType": "Custom"
}
}
]
}
Definíciók
Name | Description |
---|---|
Cloud |
Egy szabályzatművelet hibaválasza. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
Hibaválasz |
Metadata |
A paraméter általános metaadatai. |
Parameter |
A szabályzathoz megadható paraméter definíciója. |
parameter |
A paraméter adattípusa. |
Policy |
A szabályzatdefiníciós verzió azonosítója. |
Policy |
A szabályzatdefiníciós verziók listája. |
policy |
A szabályzatdefiníció típusa. Lehetséges értékek: NotSpecified, BuiltIn, Custom és Static. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
CloudError
Egy szabályzatművelet hibaválasza.
Name | Típus | Description |
---|---|---|
error |
Hibaválasz |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
Metadata
A paraméter általános metaadatai.
Name | Típus | Description |
---|---|---|
assignPermissions |
boolean |
Állítsa igaz értékre, hogy Azure Portal szerepkör-hozzárendeléseket hozzon létre a paraméter erőforrás-azonosítóján vagy erőforrás-hatókörének értékén a szabályzat-hozzárendelés során. Ez a tulajdonság akkor hasznos, ha a hozzárendelés hatókörén kívül szeretne engedélyeket hozzárendelni. |
description |
string |
A paraméter leírása. |
displayName |
string |
A paraméter megjelenítendő neve. |
strongType |
string |
A szabályzatdefiníció portálon keresztüli hozzárendeléséhez használatos. A felhasználó számára kiválasztandó értékek környezetfüggő listáját tartalmazza. |
ParameterDefinitionsValue
A szabályzathoz megadható paraméter definíciója.
Name | Típus | Description |
---|---|---|
allowedValues |
object[] |
A paraméter engedélyezett értékei. |
defaultValue |
object |
A paraméter alapértelmezett értéke, ha nincs megadva érték. |
metadata |
A paraméter általános metaadatai. |
|
schema |
object |
A paraméterbemenetek ellenőrzését biztosítja a hozzárendelés során egy ön definiált JSON-sémával. Ez a tulajdonság csak objektumtípus-paraméterek esetén támogatott, és a Json.NET Schema 2019-09 implementációt követi. A sémák használatáról és a vázlatsémák https://json-schema.org/ teszteléséről a következő címen tudhat meg többet: https://www.jsonschemavalidator.net/. |
type |
A paraméter adattípusa. |
parameterType
A paraméter adattípusa.
Name | Típus | Description |
---|---|---|
Array |
string |
|
Boolean |
string |
|
DateTime |
string |
|
Float |
string |
|
Integer |
string |
|
Object |
string |
|
String |
string |
PolicyDefinitionVersion
A szabályzatdefiníciós verzió azonosítója.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
id |
string |
A szabályzatdefiníciós verzió azonosítója. |
|
name |
string |
A szabályzatdefiníciós verzió neve. |
|
properties.description |
string |
A szabályzatdefiníció leírása. |
|
properties.displayName |
string |
A szabályzatdefiníció megjelenítendő neve. |
|
properties.metadata |
object |
A szabályzatdefiníció metaadatai. A metaadatok egy nyitott befejezett objektum, amely általában kulcsértékpárok gyűjteménye. |
|
properties.mode |
string |
Indexed |
A szabályzatdefiníciós mód. Néhány példa: Mind, Indexelt, Microsoft.KeyVault.Data. |
properties.parameters |
<string,
Parameter |
A szabályzatszabályban használt paraméterek paraméterdefiníciói. A kulcsok a paraméternevek. |
|
properties.policyRule |
object |
A szabályzatszabály. |
|
properties.policyType |
A szabályzatdefiníció típusa. Lehetséges értékek: NotSpecified, BuiltIn, Custom és Static. |
||
properties.version |
string |
A szabályzatdefiníció verziója #.#.# formátumban. |
|
systemData |
Az erőforráshoz kapcsolódó rendszer metaadatai. |
||
type |
string |
Az erőforrás típusa (Microsoft.Authorization/policyDefinitions/versions). |
PolicyDefinitionVersionListResult
A szabályzatdefiníciós verziók listája.
Name | Típus | Description |
---|---|---|
nextLink |
string |
A következő találatok lekéréséhez használandó URL-cím. |
value |
A szabályzatdefiníciók verzióinak tömbje. |
policyType
A szabályzatdefiníció típusa. Lehetséges értékek: NotSpecified, BuiltIn, Custom és Static.
Name | Típus | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
NotSpecified |
string |
|
Static |
string |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |