Policy Definition Versions - Get At Management Group
Haal een beleidsdefinitieversie op in een beheergroep.
Met deze bewerking wordt de versie van de beleidsdefinitie in de opgegeven beheergroep met de opgegeven naam opgehaald.
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}/versions/{policyDefinitionVersion}?api-version=2023-04-01
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: |
policy
|
path | True |
string |
De beleidsdefinitieversie. De notatie is x.y.z, waarbij x het primaire versienummer is, y het secundaire versienummer is en z het patchnummer Regex pattern: |
api-version
|
query | True |
string |
De API-versie die voor deze bewerking moet worden gebruikt. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK: retourneert informatie over de beleidsdefinitie. |
|
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
Retrieve a policy definition version at management group level
Sample Request
Sample Response
{
"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"
}
}
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 |
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). |
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. |