Vaults - List

Serviço:

Key Vault

Versão da API:

2024-11-01

A operação List obtém informações sobre os cofres associados à assinatura.

GET https://management.azure.com/subscriptions/{subscriptionId}/resources?$filter=resourceType eq 'Microsoft.KeyVault/vaults'&api-version=2015-11-01

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/resources?$filter=resourceType eq 'Microsoft.KeyVault/vaults'&$top={$top}&api-version=2015-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
$filter	query	True	VaultListFilterTypes	O filtro a ser aplicado na operação.
api-version	query	True	ResourceManagerApiVersions	Versão da API do Azure Resource Manager.
$top	query		integer (int32)	Número máximo de resultados a devolver.

Respostas

Name	Tipo	Description
200 OK	ResourceListResult	Obtenha informações sobre todos os cofres de chaves na subscrição.
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou.

Exemplos

List vaults in the specified subscription

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resources?$filter=resourceType eq 'Microsoft.KeyVault/vaults'&$top=1&api-version=2015-11-01

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault",
      "name": "sample-vault",
      "type": "Microsoft.KeyVault/vaults",
      "location": "westus",
      "tags": {}
    }
  ],
  "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resources?%24filter=resourceType+eq+%27Microsoft.KeyVault%2fvaults%27&%24top=4&api-version=2015-11-01&%24skiptoken=eyJuZXh0UGFydGl0aW9uS2V5IjoiMSE4IVEwTTJNVGMtIiwibmV4dFJvd0tleSI6IjEhMTMyIU5rUTRSVEU1UXpJelFUWXdORGd4UmpoRlFrSXhNVGhFUXpNd01EZEROVVJmVkVkT1RDMU5TVU5TVDFOUFJsUTZNa1ZMUlZsV1FWVk1WRG95UmxaQlZVeFVVeTFUVTFKSExVcEpUVG95UkZSRlUxUTZNa1JXUVZWTVZDMVhSVk5VVlZNLSJ9"
}

Definições

Name	Description
CloudError	Uma resposta de erro do provedor de recursos Key Vault
CloudErrorBody	Uma resposta de erro do provedor de recursos Key Vault
Resource	Recurso Key Vault
ResourceListResult	Lista de recursos do vault.
ResourceManagerApiVersions	Versão da API do Azure Resource Manager.
VaultListFilterTypes	O filtro a ser aplicado na operação.

CloudError

Object

Uma resposta de erro do provedor de recursos Key Vault

Name	Tipo	Description
error	CloudErrorBody	Uma resposta de erro do provedor de recursos Key Vault

CloudErrorBody

Object

Uma resposta de erro do provedor de recursos Key Vault

Name	Tipo	Description
code	string	Código de erro. Este é um mnemônico que pode ser consumido programaticamente.
message	string	Mensagem de erro amigável. A mensagem é normalmente localizada e pode variar com a versão do serviço.

Resource

Object

Recurso Key Vault

Name	Tipo	Description
id	string	Identificador totalmente qualificado do recurso do cofre de chaves.
location	string	Localização do Azure do recurso do cofre de chaves.
name	string	Nome do recurso do cofre de chaves.
tags	object	Tags atribuídas ao recurso do cofre de chaves.
type	string	Tipo de recurso do recurso do cofre de chaves.

ResourceListResult

Object

Lista de recursos do vault.

Name	Tipo	Description
nextLink	string	O URL para obter o próximo conjunto de recursos do cofre.
value	Resource[]	A lista de recursos do vault.

ResourceManagerApiVersions

Enumeração

Versão da API do Azure Resource Manager.

Valor	Description
2015-11-01

VaultListFilterTypes

Enumeração

O filtro a ser aplicado na operação.

Valor	Description
resourceType eq 'Microsoft.KeyVault/vaults'