Policy Definition Versions - List By Management Group
Recupere las versiones de definición de directiva en una definición de directiva de grupo de administración.
Esta operación recupera una lista de todas las versiones de definición de directiva para la definición de directiva especificada en el grupo de administración determinado.
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}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
management
|
path | True |
string |
Nombre del grupo de administración. El nombre distingue mayúsculas de minúsculas. |
policy
|
path | True |
string |
Nombre de la definición de directiva. Regex pattern: |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
$top
|
query |
integer int32 |
Número máximo de registros que se van a devolver. Cuando no se proporcione el filtro $top, devolverá 500 registros. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Ok: devuelve una matriz de versiones de definición de directiva. |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
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"
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Cloud |
Respuesta de error de una operación de directiva. |
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Respuesta de error |
Metadata |
Metadatos generales para el parámetro . |
Parameter |
Definición de un parámetro que se puede proporcionar a la directiva. |
parameter |
El tipo de datos del parámetro. |
Policy |
Identificador de la versión de definición de directiva. |
Policy |
Lista de versiones de definición de directiva. |
policy |
Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
CloudError
Respuesta de error de una operación de directiva.
Nombre | Tipo | Description |
---|---|---|
error |
Respuesta de error |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
Metadata
Metadatos generales para el parámetro .
Nombre | Tipo | Description |
---|---|---|
assignPermissions |
boolean |
Establézcalo en true para que Azure Portal cree asignaciones de roles en el identificador de recurso o el valor de ámbito de recurso de este parámetro durante la asignación de directiva. Esta propiedad es útil en caso de que desee asignar permisos fuera del ámbito de asignación. |
description |
string |
La descripción del parámetro. |
displayName |
string |
Nombre para mostrar del parámetro . |
strongType |
string |
Se usa al asignar la definición de directiva a través del portal. Proporciona una lista con reconocimiento de contexto de valores entre los que el usuario debe elegir. |
ParameterDefinitionsValue
Definición de un parámetro que se puede proporcionar a la directiva.
Nombre | Tipo | Description |
---|---|---|
allowedValues |
object[] |
Valores permitidos para el parámetro . |
defaultValue |
object |
Valor predeterminado del parámetro si no se proporciona ningún valor. |
metadata |
Metadatos generales para el parámetro . |
|
schema |
object |
Proporciona validación de entradas de parámetro durante la asignación mediante un esquema JSON autodefinido. Esta propiedad solo se admite para los parámetros de tipo de objeto y sigue la implementación 2019-09 del esquema Json.NET. Puede obtener más información sobre el uso de esquemas en https://json-schema.org/ y probar borradores de esquemas en https://www.jsonschemavalidator.net/. |
type |
El tipo de datos del parámetro. |
parameterType
El tipo de datos del parámetro.
Nombre | Tipo | Description |
---|---|---|
Array |
string |
|
Boolean |
string |
|
DateTime |
string |
|
Float |
string |
|
Integer |
string |
|
Object |
string |
|
String |
string |
PolicyDefinitionVersion
Identificador de la versión de definición de directiva.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
id |
string |
Identificador de la versión de definición de directiva. |
|
name |
string |
Nombre de la versión de definición de directiva. |
|
properties.description |
string |
Descripción de la definición de directiva. |
|
properties.displayName |
string |
Nombre para mostrar de la definición de directiva. |
|
properties.metadata |
object |
Metadatos de definición de directiva. Los metadatos son un objeto abierto y normalmente es una colección de pares clave-valor. |
|
properties.mode |
string |
Indexed |
Modo de definición de directiva. Algunos ejemplos son All, Indexed, Microsoft.KeyVault.Data. |
properties.parameters |
<string,
Parameter |
Definiciones de parámetros para parámetros usados en la regla de directiva. Las claves son los nombres de parámetro. |
|
properties.policyRule |
object |
Regla de directiva. |
|
properties.policyType |
Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static. |
||
properties.version |
string |
La versión de definición de directiva en formato #.#.#. |
|
systemData |
Metadatos del sistema relacionados con este recurso. |
||
type |
string |
Tipo del recurso (Microsoft.Authorization/policyDefinitions/versions). |
PolicyDefinitionVersionListResult
Lista de versiones de definición de directiva.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Dirección URL que se va a usar para obtener el siguiente conjunto de resultados. |
value |
Matriz de versiones de definiciones de directiva. |
policyType
Tipo de definición de directiva. Los valores posibles son NotSpecified, BuiltIn, Custom y Static.
Nombre | Tipo | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
NotSpecified |
string |
|
Static |
string |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |