Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Demandes REST
Les requêtes REST Amazon Route 53 sont des requêtes HTTPS, telles que définies par la RFC 2616
Une action REST classique consiste à envoyer une seule requête HTTPS à Route 53 et à attendre la réponse. Comme toute requête HTTP, une requête REST adressée à Route 53 contient une méthode de requête, un URI, des en-têtes de requête 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.
URI de demande
L'URI de la demande commence toujours par une barre oblique, puis par la version de l'API Route 53 que vous utilisez (par exemple, 2013-04-01). Le reste de l'URI indique la ressource particulière sur laquelle vous voulez agir. Par exemple, voici l'URI que vous utilisez lors de la création d'une nouvelle zone hébergée. (Pour plus d’informations, consultez CreateHostedZone.)
/2013-04-01/hostedzone
À 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 du AWS système lorsque la demande est reçue. Dans le cas contraire, la demande échoue avec le code d'erreur RequestExpired. Cela a pour objectif d'empêcher la ré-émission de vos demandes par un adversaire.
La date doit être spécifiée au format ISO 8601, 2016-03-03T19:20:25.177Z par exemple. Pour plus d'informations sur le format ISO 8601, consultez l'article Wikipédia ISO 8601
Corps de la requête
La plupart des actions de l'API Route 53 nécessitent que vous incluiez du code XML dans le corps de la demande. Le XML est conforme au schéma Route 53.
Exemple Exemple de requête
L'exemple de demande suivant utilise une simple instruction XML pour créer une zone hébergée nommée example.com avec l'identifiant de référence, my UniqueIdentifier.
Les éléments XML de votre demande doivent apparaître dans l'ordre indiqué.
POST /2013-04-01/hostedzone HTTP/1.1 host:route53.amazonaws.com x-amz-date:date and time of the requestauthorization: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[Other required headers]<?xml version="1.0" encoding="UTF-8"?> <CreateHostedZoneRequest xmlns="https://route53.amazonaws.com/ doc/2013-04-01/"> <Name>example.com.</Name> <CallerReference>myUniqueIdentifier</CallerReference> <HostedZoneConfig> <Comment>This is my hosted zone.</Comment> </HostedZoneConfig> </CreateHostedZoneRequest>
