Parámetros comunes - - Centro de documentación de Alibaba Cloud

Cada solicitud y respuesta de la API de KMS incluye un conjunto de parámetros comunes. En esta página se enumeran dichos parámetros con sus tipos, requisitos y valores aceptados.

Parámetros de solicitud comunes

Incluya estos parámetros en cada solicitud de API.

Parámetro	Tipo	Obligatorio	Descripción
Format	String	No	Formato de la respuesta. Valores válidos: `JSON` (predeterminado), `XML`.
Version	String	Sí	Número de versión de la API en formato `YYYY-MM-DD`. Establezca este valor en `2016-01-20`.
AccessKeyId	String	Sí	El ID de accesskey asociado a su cuenta de Alibaba Cloud.
Signature	String	Sí	La cadena de firma para la solicitud actual.
SignatureMethod	String	Sí	Algoritmo de firma. Establezca este valor en `HMAC-SHA1`.
Timestamp	String	Sí	Marca de tiempo de la solicitud en formato ISO 8601: `yyyy-MM-ddTHH:mm:ssZ`. Debe estar en UTC. Ejemplo: `2022-01-10T12:00:00Z` representa el 10 de enero de 2022, 20:00:00 (UTC+8).
SignatureVersion	String	Sí	Versión del algoritmo de firma. Establezca este valor en `1.0`.

Solicitud de ejemplo

https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateKey
&Format=json
&Version=2016-01-20
&AccessKeyId=te****
&Signature=YlrFhyqDZQ1ThNYARrv3Ptaxqf****
&SignatureMethod=HMAC-SHA1
&Timestamp=2022-01-10T12:00:00Z
&SignatureVersion=1.0

Parámetros de respuesta comunes

Las respuestas se devuelven en formato JSON o XML, según el valor de Format en la solicitud. El formato predeterminado es JSON.

Cada respuesta, sea exitosa o no, incluye un valor único de RequestId. Utilice este valor al contactar al soporte técnico de Alibaba Cloud.

Códigos de estado HTTP

Código de estado	Significado
`2xx`	La solicitud se completó correctamente.
`4xx`	La solicitud terminó con errores debido a un error del cliente.
`5xx`	La solicitud terminó con errores debido a un error del servidor.

Respuestas de ejemplo

Formato JSON

{
    "RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
}

Formato XML

<?xml version="1.0" encoding="utf-8"?>
<KMS>
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
</KMS>