Este tópico descreve os parâmetros comuns de requisição e resposta da API do Serverless App Engine (SAE).
Parâmetros comuns de requisição
Inclua os parâmetros comuns de requisição em todas as chamadas à API do SAE.
|
Parâmetro |
Exemplo |
Obrigatório |
Descrição |
|
Authorization |
acs |
Sim |
Informações de autenticação para validar a requisição. A string deve seguir o formato |
|
Content-Length |
0 |
Sim |
Tamanho do conteúdo da requisição HTTP, conforme especificado na RFC 2616. |
|
Content-Type |
application/json |
Sim |
Tipo de conteúdo da requisição HTTP. O valor deve obedecer ao formato definido na RFC 2616. |
|
Content-MD5 |
0e30656xxxxxxxxx0bc6f70bbdfe |
Sim |
Hash MD5 de 128 bits codificado em Base64 do corpo da requisição HTTP. Defina este parâmetro em todas as requisições para evitar adulteração de dados. |
|
Date |
Mon, 26 Aug 2019 08:55:56 GMT |
Sim |
Horário de criação da requisição, obrigatoriamente em GMT. Se o intervalo entre o envio e o recebimento ultrapassar 15 minutos, a requisição será considerada inválida. |
|
Host |
sae.cn-beijing.aliyuncs.com |
Sim |
Endpoint do SAE, por exemplo, sae.cn-hangzhou.aliyuncs.com. |
|
Accept |
application/json |
Sim |
Tipo de resposta esperado pelo cliente. Valores válidos: application/json e application/xml. |
|
x-acs-version |
1.0 |
Sim |
Versão da API. Defina o valor como 2019-05-06. |
|
x-acs-region-id |
cn-beijing |
Sim |
ID da região. |
|
x-acs-signature-nonce |
f63659d4-10ac-483b-99da-ea8fde61eae3 |
Sim |
Número aleatório exclusivo para prevenir ataques de replay. Utilize um número diferente para cada requisição. |
|
x-acs-signature-method |
HMAC-SHA1 |
Sim |
Método de criptografia da string de assinatura. Defina o valor como HMAC-SHA1. |
Exemplos
GET /pop/v1/paas/regionConfig HTTP/1.1
Host: sae.cn-beijing.aliyuncs.com
Accept: application/json
User-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)
x-acs-signature-nonce: f63659d4-10ac-483b-99da-ea8fde61eae3
Authorization: acs <yourAccessKeyId>:<yourSignature>
x-acs-signature-version: 1.0
Date: Mon, 26 Aug 2019 08:55:56 GMT
x-acs-signature-method: HMAC-SHA1
Content-Type: application/json;charset=utf-8
X-Acs-Region-Id: cn-beijing
Content-Length: 0
Parâmetros comuns de resposta
Toda resposta retorna um RequestID exclusivo, independentemente do sucesso da chamada. As respostas seguem um formato unificado no padrão HTTP: o código de status 2xx indica sucesso, enquanto 4xx ou 5xx indicam falha.
Formato XML
<?xml version="1.0" encoding="UTF-8"?>
<!--Result Root Node-->
<Interface Name+Response>
<!--Return Request Tag-->
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
<!--Return Result Data-->
</Interface Name+Response>
Formato JSON
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
/* Return Result Data */
}