Policy Definition Versions - List By Management Group
Beleidsdefinitieversies ophalen in een beleidsdefinitie voor beheergroepen.
Met deze bewerking wordt een lijst opgehaald met alle beleidsdefinitieversies voor de opgegeven beleidsdefinitie in de opgegeven beheergroep.
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}/versions?api-version=2023-04-01
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}/versions?api-version=2023-04-01&$top={$top}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
management
|
path | True |
string |
De naam van de beheergroep. De naam is niet hoofdlettergevoelig. |
policy
|
path | True |
string |
De naam van de beleidsdefinitie. Regex pattern: |
api-version
|
query | True |
string |
De API-versie die voor deze bewerking moet worden gebruikt. |
$top
|
query |
integer int32 |
Maximum aantal records dat moet worden geretourneerd. Wanneer het $top filter niet is opgegeven, worden 500 records geretourneerd. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK: retourneert een matrix met beleidsdefinitieversies. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | uw gebruikersaccount imiteren |
Voorbeelden
List policy definition versions by 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"
}
}
]
}
Definities
Name | Description |
---|---|
Cloud |
Een foutreactie van een beleidsbewerking. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
Foutreactie |
Metadata |
Algemene metagegevens voor de parameter. |
Parameter |
De definitie van een parameter die kan worden opgegeven voor het beleid. |
parameter |
Het gegevenstype van de parameter. |
Policy |
De id van de beleidsdefinitieversie. |
Policy |
Lijst met beleidsdefinitieversies. |
policy |
Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static. |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
CloudError
Een foutreactie van een beleidsbewerking.
Name | Type | Description |
---|---|---|
error |
Foutreactie |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
additionalInfo |
Aanvullende informatie over de fout. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
Metadata
Algemene metagegevens voor de parameter.
Name | Type | Description |
---|---|---|
assignPermissions |
boolean |
Stel in op true om tijdens beleidstoewijzingen roltoewijzingen te maken voor de resource-id of resourcebereikwaarde van deze parameter Azure Portal. Deze eigenschap is handig als u machtigingen buiten het toewijzingsbereik wilt toewijzen. |
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. |
ParameterDefinitionsValue
De definitie van een parameter die kan worden opgegeven voor het beleid.
Name | Type | Description |
---|---|---|
allowedValues |
object[] |
De toegestane waarden voor de parameter. |
defaultValue |
object |
De standaardwaarde voor de parameter als er geen waarde is opgegeven. |
metadata |
Algemene metagegevens voor de parameter. |
|
schema |
object |
Biedt validatie van parameterinvoer tijdens de toewijzing met behulp van een zelf-gedefinieerd JSON-schema. Deze eigenschap wordt alleen ondersteund voor objecttypeparameters en volgt de implementatie van Json.NET Schema 2019-09. Meer informatie over het gebruik van schema's vindt u op https://json-schema.org/ en testconceptschema's op https://www.jsonschemavalidator.net/. |
type |
Het gegevenstype van de parameter. |
parameterType
Het gegevenstype van de parameter.
Name | Type | Description |
---|---|---|
Array |
string |
|
Boolean |
string |
|
DateTime |
string |
|
Float |
string |
|
Integer |
string |
|
Object |
string |
|
String |
string |
PolicyDefinitionVersion
De id van de beleidsdefinitieversie.
Name | Type | Standaardwaarde | Description |
---|---|---|---|
id |
string |
De id van de beleidsdefinitieversie. |
|
name |
string |
De naam van de beleidsdefinitieversie. |
|
properties.description |
string |
De beschrijving van de beleidsdefinitie. |
|
properties.displayName |
string |
De weergavenaam van de beleidsdefinitie. |
|
properties.metadata |
object |
De metagegevens van de beleidsdefinitie. Metagegevens zijn een open-ended object en zijn meestal een verzameling sleutelwaardeparen. |
|
properties.mode |
string |
Indexed |
De beleidsdefinitiemodus. Enkele voorbeelden zijn All, Indexed, Microsoft.KeyVault.Data. |
properties.parameters |
<string,
Parameter |
De parameterdefinities voor parameters die worden gebruikt in de beleidsregel. De sleutels zijn de parameternamen. |
|
properties.policyRule |
object |
De beleidsregel. |
|
properties.policyType |
Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static. |
||
properties.version |
string |
De beleidsdefinitieversie in #.#.#-indeling. |
|
systemData |
De systeemmetagegevens met betrekking tot deze resource. |
||
type |
string |
Het type resource (Microsoft.Authorization/policyDefinitions/versions). |
PolicyDefinitionVersionListResult
Lijst met beleidsdefinitieversies.
Name | Type | Description |
---|---|---|
nextLink |
string |
De URL die moet worden gebruikt om de volgende set resultaten op te halen. |
value |
Een matrix met beleidsdefinitieversies. |
policyType
Het type beleidsdefinitie. Mogelijke waarden zijn NotSpecified, BuiltIn, Custom en Static.
Name | Type | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
NotSpecified |
string |
|
Static |
string |
systemData
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
Het tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource het laatst heeft gewijzigd. |