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

Este tema describe los parámetros de solicitud y respuesta comunes de la API de Serverless App Engine (SAE).

Parámetros de solicitud comunes

Todas las solicitudes a la API de SAE deben incluir los parámetros de solicitud comunes.

Parámetro	Ejemplo	Obligatorio	Descripción
Authorization	acs :	Sí	Información de autenticación para comprobar la validez de una solicitud. La cadena debe seguir el formato `AccessKeyId:Signature`.
Content-Length	0	Sí	Longitud del contenido de la solicitud HTTP, especificada en RFC 2616.
Content-Type	application/json	Sí	Tipo de contenido de la solicitud HTTP. Debe seguir el formato especificado en RFC 2616.
Content-MD5	0e30656xxxxxxxxx0bc6f70bbdfe	Sí	Valor hash MD5 de 128 bits codificado en Base64 del cuerpo de la solicitud HTTP. Se recomienda establecer este parámetro en todas las solicitudes para evitar la manipulación de parámetros.
Date	Mon, 26 Aug 2019 08:55:56 GMT	Sí	Hora de creación de la solicitud. Debe expresarse en GMT. Si transcurren más de 15 minutos entre el envío y la recepción, la solicitud se considera no válida.
Host	sae.cn-beijing.aliyuncs.com	Sí	Endpoint de SAE; por ejemplo, sae.cn-hangzhou.aliyuncs.com.
Accept	application/json	Sí	Tipo de respuesta que requiere el cliente. Valores válidos: application/json y application/xml.
x-acs-version	1.0	Sí	Versión de la API. Establezca el valor en 2019-05-06.
x-acs-region-id	cn-beijing	Sí	ID de la región.
x-acs-signature-nonce	f63659d4-10ac-483b-99da-ea8fde61eae3	Sí	Número aleatorio único para prevenir ataques de repetición. Cada solicitud requiere un número distinto.
x-acs-signature-method	HMAC-SHA1	Sí	Método de cifrado de la cadena de firma. Establezca el valor en HMAC-SHA1.

Ejemplos

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 de respuesta comunes

Cada respuesta devuelve un RequestID único, independientemente de si la llamada fue exitosa. Todas las respuestas siguen un formato unificado basado en el protocolo HTTP: un código de estado 2xx indica una llamada exitosa, mientras que un código 4xx o 5xx señala una llamada con errores.

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 */
}