Parâmetros comuns - : Central de Documentação do Alibaba Cloud

Todas as solicitações e respostas da API do KMS incluem um conjunto de parâmetros comuns. Esta página lista esses parâmetros, seus tipos, obrigatoriedade e valores aceitos.

Parâmetros comuns de solicitação

Inclua estes parâmetros em todas as solicitações de API.

Parâmetro	Tipo	Obrigatório	Descrição
Format	String	Não	Formato da resposta. Valores válidos: `JSON` (padrão) e `XML`.
Version	String	Sim	Número da versão da API no formato `YYYY-MM-DD`. Defina como `2016-01-20`.
AccessKeyId	String	Sim	AccessKey ID associado à sua conta Alibaba Cloud.
Signature	String	Sim	String de assinatura da solicitação atual.
SignatureMethod	String	Sim	Algoritmo de assinatura. Defina como `HMAC-SHA1`.
Timestamp	String	Sim	Carimbo de data/hora da solicitação no formato ISO 8601: `yyyy-MM-ddTHH:mm:ssZ`. Use o fuso horário UTC. Exemplo: `2022-01-10T12:00:00Z` representa 10 de janeiro de 2022, 20:00:00 (UTC+8).
SignatureVersion	String	Sim	Versão do algoritmo de assinatura. Defina como `1.0`.

Exemplo de solicitação

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 comuns de resposta

As respostas retornam no formato JSON ou XML, conforme o valor de Format na solicitação. O padrão é JSON.

Toda resposta, bem-sucedida ou não, inclui um RequestId exclusivo. Use esse valor ao contatar o suporte da Alibaba Cloud.

Códigos de status HTTP

Código de status	Significado
`2xx`	Solicitação bem-sucedida.
`4xx`	Falha na solicitação devido a erro do cliente.
`5xx`	Falha na solicitação devido a erro do servidor.

Exemplos de resposta

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>