Códigos de error comunes - Key Management Service - Centro de documentación de Alibaba Cloud

Cuando una solicitud de API de KMS falla, KMS devuelve un código de estado HTTP y detalles del error en el cuerpo de la respuesta. Los detalles del error se codifican en formato Protocol Buffers:

message Error {
     int32 StatusCode = 1;
     string ErrorCode = 2;
     string ErrorMessage = 3;
     string RequestId = 4;
}

Los siguientes códigos de error aplican a la mayoría de las operaciones de KMS. Algunas operaciones devuelven códigos adicionales descritos en sus respectivos temas de referencia de API.

400 Bad request

Código de error	Mensaje de error	Significado y solución
`InvalidApiName`	The ApiName "\" is invalid.	El nombre de la API en la solicitud no es válido. Compruebe el nombre de la API y corríjalo.
`InvalidApiVersion`	The ApiVersion "\" is invalid.	Falta el campo de encabezado `x-kms-apiversion` en la solicitud. Agréguelo al encabezado de la solicitud.
`InvalidParam`	The Param Date is invalid.	El valor del encabezado `Date` no cumple con RFC 1123. Actualice el encabezado `Date` para usar un valor compatible con RFC 1123.
`InvalidParam`	The Param x-kms-signaturemethod is invalid.	Falta el campo de encabezado `x-kms-signaturemethod` en la solicitud. Agréguelo al encabezado de la solicitud.
`InvalidParam`	The Param x-kms-signaturemethod is invalid. message:"\".	El método de firma especificado en `x-kms-signaturemethod` no es compatible. Use un método de firma compatible.
`MissingParameter`	Parameter x-kms-acccesskeyid does not exist in http header or body.	No se encontró ningún AccessKey ID en el encabezado `Authorization`. Agregue su AccessKey ID al encabezado `Authorization`. Si usa los SDK de Alibaba Cloud, asegúrese de utilizar el KMS Instance SDK.
`RequestTimeTooSkewed`	Request time exceeds server time more than 15 minutes.	La marca de tiempo de la solicitud difiere de la hora del servidor por más de 15 minutos. Sincronice el reloj del servidor e inténtelo de nuevo.
`InvalidParameter`	The specified parameter is not valid.	Un valor de parámetro no es válido. Compruebe el valor del parámetro y corríjalo.
`UnsupportedOperation`	Rejected.UnsupportedOperation	La operación solicitada no es compatible. Para obtener más información, consulte Application access FAQ.

401 Unauthorized

Código de error	Mensaje de error	Significado y solución
`SignatureNotMatch`	Signature is not matched.	La firma del cliente no coincide con la firma calculada por el servidor. Use una clave de cliente válida e inténtelo de nuevo.

403 Forbidden

Código de error	Mensaje de error	Significado y solución
`Forbidden.NoPermission`	This operation for "\" is forbidden by permission system.	Su punto de acceso de aplicación (AAP) no tiene permiso para realizar esta operación. Revise las directivas de permisos del AAP. Para obtener instrucciones, consulte Create an AAP.

404 Not found

Código de error	Mensaje de error	Significado y solución
`Forbidden.KeyNotFound`	The Key ID or Alias does not exist in the system.	La clave especificada no existe. Compruebe el ID de la clave o el alias e inténtelo de nuevo.
`Forbidden.KeyNotFound`	The Key ID or Alias does not exist in the key store "\".	La clave especificada no existe en el almacén de claves indicado. Compruebe el nombre del almacén de claves y el ID de la clave o el alias.
`Forbidden.KeyNotFound`	The specified key does not exist.	La clave especificada no existe. Compruebe el ID de la clave o el alias e inténtelo de nuevo.
`Unauthorized`	The AccessKey ID "\" does not exist in our records.	No se encontró el AccessKey ID. El AccessKey ID corresponde al valor `KeyId` en su AAP. Compruebe su clave de cliente. Para obtener instrucciones, consulte Create an AAP.

409 Conflict

Estos errores ocurren cuando la clave se encuentra en un estado que no permite la operación solicitada.

Código de error	Mensaje de error	Estado de la clave	Significado y solución
`Rejected.PendingDeletion`	The request was rejected because the key state is PendingDeletion.	PendingDeletion	La clave está programada para eliminación. Cancele la eliminación o use una clave diferente.
`Rejected.Disabled`	The request was rejected because the key state is Disabled.	Disabled	La clave está deshabilitada. Vuelva a habilitar la clave antes de usarla.
`Rejected.PendingImport`	The request was rejected because the key state is PendingImport.	PendingImport	La clave está en espera de importación de material de clave. Complete la importación o use una clave diferente.

413 Request entity too large

Después de codificar todos los parámetros de la solicitud en formato Protocol Buffers, el cuerpo de la solicitud supera los 3 MB.

Para evitar este error:

Cifrado y descifrado: Mantenga las cargas útiles por debajo de 6 KB para operaciones con claves simétricas y por debajo de 1 KB para operaciones con claves asimétricas. Para datos más grandes, use cifrado de sobre en su lugar.
Firma y verificación: Para mensajes grandes, genere un resumen del mensaje localmente y luego llame a la operación Sign o Verify con dicho resumen.

415 Unsupported media type

Código de error	Mensaje de error	Significado y solución
`InvalidContentType`	Content-Type "\" is unsupported.	El valor del encabezado `Content-Type` no es compatible. Use el tipo de contenido correcto para la solicitud.

500 Internal server error

Código de error	Mensaje de error	Significado y solución
`InternalFailure`	Internal Failure.	Ocurrió un error interno. Póngase en contacto con el soporte técnico de Alibaba Cloud. Para obtener más información, consulte Contact us.

503 Service unavailable

Código de error	Mensaje de error	Significado y solución
`ServiceUnavailableTemporary`	Service Unavailable Temporary.	El servicio no está available temporalmente. Inténtelo de nuevo más tarde.