APIAbfrageanfragen mithilfe des AWS JSON Protokolls in Amazon stellen SQS - Amazon Simple Queue Service
Erstellen eines EndpunktsEine POST Anfrage stellen

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.

APIAbfrageanfragen mithilfe des AWS JSON Protokolls in Amazon stellen SQS

In diesem Abschnitt erfahren Sie, wie Sie einen SQS Amazon-Endpunkt erstellen, POST Anfragen stellen und Antworten interpretieren.

Anmerkung

AWS JSONDas Protokoll wird für die meisten Sprachvarianten unterstützt. Eine Liste der unterstützten Sprachvarianten finden Sie unter Welche Sprachen werden für AWS JSON das in Amazon verwendete Protokoll unterstützt SQSAPIs?.

Themen

Erstellen eines Endpunkts

Um mit SQS Amazon-Warteschlangen arbeiten zu können, müssen Sie einen Endpunkt erstellen. Informationen zu SQS Amazon-Endpunkten finden Sie auf den folgenden Seiten in: Allgemeine Amazon Web Services-Referenz

Jeder SQS Amazon-Endpunkt ist unabhängig. Wenn beispielsweise zwei Warteschlangen benannt sind MyQueueund eine den Endpunkt und die sqs.us-east-2.amazonaws.com andere den Endpunkt hatsqs.eu-west-2.amazonaws.com, teilen die beiden Warteschlangen keine Daten miteinander.

Das folgende Beispiel zeigt einen Endpunkt, der eine Anforderung zum Erstellen einer Warteschlange stellt. 

POST / HTTP/1.1
Host: sqs.us-west-2.amazonaws.com
X-Amz-Target: AmazonSQS.CreateQueue
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueName":"MyQueue",
    "Attributes": {
        "VisibilityTimeout": "40"
    },
    "tags": {
        "QueueType": "Production"
    }
}
Anmerkung

Bei Warteschlangennamen und Warteschlangen wird zwischen Groß- und URLs Kleinschreibung unterschieden.

Die Struktur von AUTHPARAMS hängt von der Signatur der API Anfrage ab. Weitere Informationen finden Sie unter Signieren von AWS API Anfragen in der Allgemeinen Referenz zu Amazon Web Services.

Eine POST Anfrage stellen

Eine SQS POST Amazon-Anfrage sendet Abfrageparameter als Formular im Hauptteil einer HTTP Anfrage.

Das Folgende ist ein Beispiel für einen HTTP Header mit X-Amz-Target set to AmazonSQS.<operationName> und einen HTTP Header mit Content-Type set toapplication/x-amz-json-1.0.

POST / HTTP/1.1
Host: sqs.<region>.<domain>
X-Amz-Target: AmazonSQS.SendMessage
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueUrl": "https://sqs.<region>.<domain>/<awsAccountId>/<queueName>/",
    "MessageBody": "This is a test message"
}

Diese HTTP POST Anfrage sendet eine Nachricht an eine SQS Amazon-Warteschlange.

Anmerkung

Beide HTTP Header X-Amz-Target und Content-Type sind erforderlich.

Je nach HTTP Version des HTTP Kunden kann Ihr Kunde der HTTP Anfrage weitere Elemente hinzufügen.