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

Este tópico descreve os parâmetros comuns de solicitação e resposta.

Parâmetros comuns de solicitação

Parâmetro	Tipo	Obrigatório	Descrição
Format	String	Não	Formato de retorno da resposta. Valor padrão: XML. Valores válidos: JSON XML (padrão)
Version	String	Sim	Número da versão da API. Especifique a versão no formato AAAA-MM-DD. Defina o valor como 2019-09-10.
Signature	String	Sim	String de assinatura da solicitação atual.
SignatureMethod	String	Sim	Método de criptografia da string de assinatura. Defina o valor como HMAC-SHA1.
SignatureNonce	String	Sim	Número aleatório exclusivo para evitar ataques de repetição. Utilize números diferentes para solicitações distintas.
SignatureVersion	String	Sim	Versão do algoritmo de criptografia da assinatura. Defina o valor como 1.0.
AccessKeyId	String	Sim	AccessKey ID fornecido pela Alibaba Cloud.
Timestamp	String	Sim	Carimbo de data/hora da solicitação. Especifique a hora no padrão ISO 8601, no formato AAAA-MM-DDThh:mm:ssZ. A hora deve estar em UTC. Por exemplo, 2013-01-10T12:00:00Z representa 20:00:00 de 10 de janeiro de 2013 (UTC+8).

Exemplos de solicitações

http(s)://ros.aliyuncs.com/?Action=CreateStack
&Format=xml
&Version=2019-09-10
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dg****
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1521552885****
&SignatureVersion=1.0
&AccessKeyId=LTAI****************
&Timestamp=2020-06-01T12:00:00Z

Parâmetros comuns de resposta

As respostas podem ser retornadas nos formatos JSON ou XML. É possível especificar o formato de resposta na solicitação. O formato padrão é JSON. Toda resposta retorna um valor RequestId exclusivo, independentemente do sucesso da chamada.

Um código de status HTTP 2xx indica uma chamada bem-sucedida.
Um código de status HTTP 4xx ou 5xx indica falha na chamada.

Exemplos de respostas

Formato XML

<?xml version="1.0" encoding="utf-8"?> 
    ><!--Result root node-->
    <Operation name + Response>
        <!--Response request tag-->
        <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
        <!--Returned data-->
    </Operation name + Response>

Formato JSON

{
    "RequestId":"4C467B38-3910-447D-87BC-AC049166F216"
    /*Returned data*/
}