Requêtes RPC

Les requêtes RPC Amazon Route 53 sont des requêtes HTTPS, telles que définies par la RFC 2616. Cette section décrit la structure d'une demande RPC Route 53.

Pour une action RPC, vous envoyez une requête HTTPS à Route 53 et vous attendez la réponse. Une requête RPC adressée à Route 53 contient des en-têtes de demande et parfois une chaîne de requête ou un corps de requête. La réponse contient un code de statut HTTP, des en-têtes de réponse et parfois un corps de réponse.

À propos de l'horodatage de la demande

Vous devez fournir l'horodatage dans l'Dateen-tête HTTP ou dans l' AWS x-amz-dateen-tête (certaines bibliothèques clientes HTTP ne vous permettent pas de définir l'Dateen-tête). Lorsqu'un en-tête x-amz-date est présent, le système ignore tout en-tête Date lors de l'authentification de la demande.

L'horodatage doit se situer dans les 5 minutes suivant l'heure AWS du système au moment de la réception de la demande. Dans le cas contraire, la demande échoue avec le code d'erreur RequestExpired. Cela permet d'éviter que quelqu'un d'autre soumette une nouvelle demande.

La date doit être spécifiée au format ISO 8601, 2016-03-03T19:20:25.177Z par exemple. Pour plus d'informations, consultez l'article de Wikipedia ISO 8601.

Corps de la requête

De nombreuses actions de l'API Route 53 nécessitent que vous incluiez du JSON dans le corps de la demande. Le JSON est conforme au schéma Route 53 pour l'enregistrement de domaine ou pour le résolveur Route 53.

Exemple Exemple de requête

L'exemple de demande suivant utilise une simple instruction JSON pour déterminer si le nom de domaine example.com est disponible.

Les éléments JSON de votre demande doivent apparaître dans l'ordre indiqué.

POST / HTTP/1.1  
host:route53domains.us-east-1.amazonaws.com
x-amz-date:date and time of the request
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/date of the request in yyyymmdd format/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=computed signature
x-amz-target:Route53Domains_v20140515.CheckDomainAvailability 
user-agent:information about the source of the request 
content-type:application/x-amz-json- 1.1
content-length:length
connections:Keep-Alive
{
   "DomainName":"example.com"
}