Paramètres et en-têtes communs
Les informations suivantes sont communes à l’ensemble des opérations possibles sur les ressources Key Vault :
- L’en-tête HTTP
Host
doit toujours être présent et spécifier le nom d’hôte du coffre. Exemple :Host: contoso.vault.azure.net
. Notez que la plupart des technologies clientes remplissent l’en-têteHost
à partir de l’URI. Par exemple,GET https://contoso.vault.azure.net/secrets/mysecret{...}
définit leHost
commecontoso.vault.azure.net
. Si vous accédez à Key Vault à l’aide d’une adresse IP brute commeGET https://10.0.0.23/secrets/mysecret{...}
, la valeur automatique de l’en-têteHost
est incorrecte et vous devez vous assurer manuellement que l’en-têteHost
contient le nom d’hôte du coffre. - Remplacez
{api-version}
par la version de l’API dans l’URI. - Remplacez
{subscription-id}
par l’identificateur de votre abonnement dans l’URI - Remplacez
{resource-group-name}
par le groupe de ressources. Pour plus d’informations, consultez la rubrique Utilisation des groupes de ressources pour gérer vos ressources Azure. - Remplacez
{vault-name}
par le nom de votre coffre de clés dans l’URI. - Définissez l’en-tête Content-Type sur application/json.
- Définissez l’en-tête d’autorisation sur un JSON Web Token que vous avez obtenu de Microsoft Entra ID. Pour plus d’informations, consultez Demandes d’authentification Azure Resource Manager.
Réponse d’erreur commune
Le service utilise les codes d’état HTTP pour indiquer la réussite ou l’échec. En outre, les échecs contiennent une réponse au format suivant :
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Nom de l'élément | Type | Description |
---|---|---|
code | string | Type d’erreur qui s’est produit. |
message | string | Description de ce qui a provoqué l’erreur. |