Effectuer des API demandes de requête à l'aide AWS JSON du protocole d'Amazon SQS - Amazon Simple Queue Service
Constitution d'un point de terminaisonFaire une POST demande

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.

Effectuer des API demandes de requête à l'aide AWS JSON du protocole d'Amazon SQS

Dans cette section, vous apprendrez à créer un point de SQS terminaison Amazon, à envoyer des POST demandes et à interpréter les réponses.

Note

AWS JSONle protocole est pris en charge pour la plupart des variantes linguistiques. Pour accéder à la liste complète des langages pris en charge, consultez Quelles sont les langues prises en charge pour AWS JSON le protocole utilisé sur Amazon SQS APIs ?.

Rubriques

Constitution d'un point de terminaison

Pour utiliser les SQS files d'attente Amazon, vous devez créer un point de terminaison. Pour plus d'informations sur les SQS points de terminaison Amazon, consultez les pages suivantes dans le Référence générale d'Amazon Web Services:

Chaque point de SQS terminaison Amazon est indépendant. Par exemple, si deux files d'attente sont nommées MyQueueet que l'une contient le point de terminaison sqs.us-east-2.amazonaws.com tandis que l'autre possède le point de terminaisonsqs.eu-west-2.amazonaws.com, les deux files d'attente ne partagent aucune donnée entre elles.

L'exemple suivant correspond à un point de terminaison lançant une requête pour créer une file d'attente. 

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"
    }
}
Note

Les noms et les files d'attente URLs distinguent les majuscules et minuscules.

La structure de AUTHPARAMS dépend de la signature de la API demande. Pour plus d'informations, consultez la section Signing AWS API Requests dans le manuel Amazon Web Services General Reference.

Faire une POST demande

Une SQS POST demande Amazon envoie les paramètres de requête sous forme de formulaire dans le corps d'une HTTP demande.

Voici un exemple d'HTTPen-tête X-Amz-Target défini sur et AmazonSQS.<operationName> d'HTTPen-tête Content-Type défini surapplication/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"
}

Cette HTTP POST demande envoie un message à une file d'SQSattente Amazon.

Note

Les deux HTTP en-têtes X-Amz-Target Content-Type sont obligatoires.

Votre HTTP client peut ajouter d'autres éléments à la HTTP demande, selon sa HTTP version.