View a markdown version of this page

REST-Anforderungen - Amazon Route 53

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

REST-Anforderungen

Amazon Route 53-REST-Anfragen sind HTTPS-Anfragen, wie in RFC 2616 definiert. In diesem Abschnitt wird die Struktur einer Route 53-REST-Anfrage beschrieben.

Eine typische REST-Aktion besteht darin, eine einzelne HTTPS-Anfrage an Route 53 zu senden und auf die Antwort zu warten. Wie jede HTTP-Anfrage enthält eine REST-Anfrage an Route 53 eine Anforderungsmethode, einen URI, Anforderungsheader und manchmal eine Abfragezeichenfolge oder einen Anforderungstext. Die Antwort enthält einen HTTP-Statuscode, Antwort-Header und manchmal auch Antworttext.

Anforderungs-URI

Der Anforderungs-URI beginnt immer mit einem Schrägstrich und dann mit der Version der Route 53-API, die Sie verwenden (z. B. 2013-04-01). Der Rest des URI gibt die genau die Ressource an, über der Sie operieren möchten. Im Folgenden finden Sie beispielsweise die URI, die Sie beim Erstellen einer neuen Hosting-Zone verwenden. (Weitere Informationen finden Sie unter CreateHostedZone.)

/2013-04-01/hostedzone

Über den Zeitstempel der Anforderung

Sie müssen den Zeitstempel entweder im Date HTTP-Header oder im AWS x-amz-date Header angeben (in einigen HTTP-Clientbibliotheken können Sie den Date Header nicht festlegen). Ist der Header x-amz-date vorhanden, ignoriert das System bei der Anforderungsauthentifizierung alle Header des Typs Date.

Der Zeitstempel muss innerhalb von 5 Minuten von der AWS Systemzeit abweichen, zu der die Anforderung eingegangen ist. Wenn dies nicht der Fall ist, schlägt die Anfrage mit RequestExpired-Fehlercode fehl. Auf diese Weise wird verhindert, dass Anfragen unbefugterweise wiederholt werden.

Das Datum muss beispielsweise im Format ISO 8601 angegeben werden. 2016-03-03T19:20:25.177Z Weitere Informationen über das ISO 8601-Format finden Sie im Wikipedia-Artikel ISO 8601.

Anforderungstext

Bei vielen der Route 53-API-Aktionen müssen Sie XML in den Hauptteil der Anfrage aufnehmen. Das XML entspricht dem Route 53-Schema.

Beispiel Beispielanforderung

Die folgende Beispielanforderung verwendet eine einfache XML-Anweisung, um eine gehostete Zone namens example.com mit der Referenz-ID my zu erstellen. UniqueIdentifier

Die XML-Elemente in Ihrer Anfrage müssen in der angegebenen Reihenfolge erscheinen.

POST /2013-04-01/hostedzone HTTP/1.1 host:route53.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 [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>