Parámetros y encabezados comunes
La siguiente información es común a todas las operaciones que puede realizar en los recursos de Key Vault:
- El encabezado HTTP
Host
debe estar siempre presente y debe especificar el nombre de host del almacén. Ejemplo:Host: contoso.vault.azure.net
. Tenga en cuenta que la mayoría de las tecnologías de cliente rellenan el encabezadoHost
del URI. Por ejemplo,GET https://contoso.vault.azure.net/secrets/mysecret{...}
establecerá elHost
comocontoso.vault.azure.net
. Si tiene acceso a Key Vault mediante una dirección raw IP, comoGET https://10.0.0.23/secrets/mysecret{...}
, el valor automático del encabezado deHost
será incorrecto y tendrá que asegurarse de que el encabezado deHost
contiene el nombre de host del almacén de forma manual. - Reemplace
{api-version}
por la versión de api del URI. - Reemplace
{subscription-id}
por el identificador de suscripción del URI. - Sustituya
{resource-group-name}
por el grupo de recursos. Para más información, consulte el artículo Uso de grupos de recursos para administrar los recursos de Azure. - Reemplace
{vault-name}
por el nombre del almacén de claves del URI. - Establezca el encabezado Content-Type en application/json.
- Establezca el encabezado de autorización en un token web de JSON que se obtiene de Microsoft Entra ID. Par más información, consulte Solicitudes de autenticación de Azure Resource Manager.
Respuestas de errores habituales
El servicio usará códigos de estado HTTP para indicar el éxito o el error. Además, los errores contienen una respuesta en el formato siguiente:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Nombre del elemento | Tipo | Descripción |
---|---|---|
código | string | El tipo de error que se produjo. |
message | string | Una descripción de lo que produjo el error. |