Policy Set Definition Versions - List All Builtins

Serviço:: Policy

Versão da API:: 2025-11-01

Lista todas as versões embutidas de definição de conjunto de políticas.
Essa operação lista todas as versões embutidas de definição de conjunto de políticas para todas as definições de conjuntos de políticas embutidas.

POST https://management.azure.com/providers/Microsoft.Authorization/listPolicySetDefinitionVersions?api-version=2025-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	PolicySetDefinitionVersionListResult	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List all built-in policy definition versions

Solicitação de exemplo

HTTP

POST https://management.azure.com/providers/Microsoft.Authorization/listPolicySetDefinitionVersions?api-version=2025-11-01

Resposta de exemplo

Código de status:: 200

{
  "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"
      }
    }
  ]
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ParameterDefinitionsValue	A definição de um parâmetro que pode ser fornecido à apólice.
ParameterDefinitionsValueMetadata	Metadados gerais para o parâmetro.
ParameterType	O tipo de dados do parâmetro.
ParameterValuesValue	O valor de um parâmetro.
PolicyDefinitionGroup	O grupo de definição de políticas.
PolicyDefinitionReference	A referência da definição da política.
PolicySetDefinitionVersion	A versão de definição do conjunto de políticas.
PolicySetDefinitionVersionListResult	A resposta de uma operação de lista PolicySetDefinitionVersion.
PolicyType	O tipo de definição de política. Os valores possíveis são NotSpecified, BuiltIn, Custom e Static.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ParameterDefinitionsValue

Objeto

A definição de um parâmetro que pode ser fornecido à apólice.

Nome	Tipo	Description
allowedValues	AllowedValues[]	Os valores permitidos para o parâmetro.
defaultValue		O valor padrão do parâmetro se nenhum valor for fornecido.
metadata	ParameterDefinitionsValueMetadata	Metadados gerais para o parâmetro.
schema		Fornece a validação de entradas de parâmetro durante a atribuição usando um esquema JSON autodefinido. Essa propriedade é suportada apenas para parâmetros de tipo de objeto e segue a implementação do Esquema Json.NET 2019-09. Você pode aprender mais sobre o uso de esquemas em https://json-schema.org/ e rascunho de teste em https://www.jsonschemavalidator.net/.
type	ParameterType	O tipo de dados do parâmetro.

ParameterDefinitionsValueMetadata

Objeto

Metadados gerais para o parâmetro.

Nome	Tipo	Description
assignPermissions	boolean	Defina como true para que o portal Azure crie atribuições de funções no ID de recurso ou valor do escopo desse parâmetro durante a atribuição de políticas. Essa propriedade é útil caso você deseje atribuir permissões fora do escopo de atribuição.
description	string	A descrição do parâmetro.
displayName	string	O nome de exibição do parâmetro.
strongType	string	Usado ao atribuir a definição de política por meio do portal. Fornece uma lista de valores com reconhecimento de contexto para o usuário escolher.

ParameterType

Enumeração

O tipo de dados do parâmetro.

Valor	Description
String	O tipo de parâmetro da string.
Array	O tipo de parâmetro do array.
Object	O tipo de parâmetro do objeto.
Boolean	O tipo de parâmetro booleano.
Integer	O tipo de parâmetro inteiro.
Float	O tipo de parâmetro flutuante.
DateTime	O tipo de parâmetro data-hora.

ParameterValuesValue

Objeto

O valor de um parâmetro.

Nome	Tipo	Description
value		O valor do parâmetro.

PolicyDefinitionGroup

Objeto

O grupo de definição de políticas.

Nome	Tipo	Description
additionalMetadataId	string	Uma ID de recurso de um recurso que contém metadados adicionais sobre o grupo.
category	string	A categoria do grupo.
description	string	A descrição do grupo.
displayName	string	O nome de exibição do grupo.
name	string	O nome do grupo.

PolicyDefinitionReference

Objeto

A referência da definição da política.

Nome	Tipo	Description
definitionVersion	string	A versão da definição de política a ser usada.
effectiveDefinitionVersion	string	A versão efetiva da definição de política em uso. Isso só está presente se solicitado via parâmetro de consulta $expand.
groupNames	string[]	O nome dos grupos aos quais essa referência de definição de política pertence.
latestDefinitionVersion	string	A versão mais recente da definição da apólice disponível. Isso só está presente se solicitado via parâmetro de consulta $expand.
parameters	<string, ParameterValuesValue>	Os valores de parâmetro para a regra de política referenciada. As chaves são os nomes dos parâmetros.
policyDefinitionId	string	A ID da definição de política ou definição do conjunto de políticas.
policyDefinitionReferenceId	string	Uma ID exclusiva (dentro da definição do conjunto de políticas) para essa referência de definição de política.