Compartilhar via


Parâmetros e cabeçalhos comuns

As seguintes informações são comuns a todas as operações que você pode executar em recursos do Key Vault:

  • O cabeçalho HTTP Host deve estar sempre presente e deve especificar o nome do host do cofre. Exemplo: Host: contoso.vault.azure.net. Observe que a maioria das tecnologias de cliente preenche o cabeçalho Host a partir do URI. Por exemplo, GET https://contoso.vault.azure.net/secrets/mysecret{...} definirá Host como contoso.vault.azure.net. Se você acessar o Key Vault usando um endereço IP bruto como GET https://10.0.0.23/secrets/mysecret{...}, o valor automático do Host cabeçalho estará errado e você precisará garantir manualmente que o Host cabeçalho contenha o nome do host do cofre.
  • Substitua {api-version} pela versão de api no URI.
  • Substitua {subscription-id} pelo identificador de sua assinatura no URI
  • Substitua {resource-group-name} pelo grupo de recursos. Para obter mais informações, consulte Como usar grupos de recursos para gerenciar seus recursos do Azure.
  • Substitua {vault-name} pelo nome do seu cofre de chaves no URI.
  • Defina o cabeçalho Content-Type como application/json.
  • Defina o cabeçalho de autorização como um token Web JSON obtido do Microsoft Entra ID. Para obter mais informações, consulte Autenticando solicitações do Azure Resource Manager .

Resposta de erro comum

O serviço usará códigos de status HTTP para indicar êxito ou falha. Além disso, as falhas contêm uma resposta no seguinte formato:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }  
Nome do elemento Tipo Descrição
código cadeia de caracteres O tipo de erro que ocorreu.
mensagem cadeia de caracteres Uma descrição do que causou o erro.

Consulte Também

Referência da API REST do Azure Key Vault