Fazendo API solicitações de consulta usando o AWS JSON protocolo na Amazon SQS

Nesta seção, você aprende como construir um SQS endpoint da Amazon, fazer POST solicitações e interpretar respostas.

nota

AWS JSONo protocolo é compatível com a maioria das variantes de linguagem. Para ver uma lista completa de variantes de linguagem compatíveis, consulte Quais idiomas são compatíveis com o AWS JSON protocolo usado na Amazon SQSAPIs?.

Tópicos

• Criar um endpoint
• Fazendo uma POST solicitação
• Interpretando as respostas da Amazon SQS JSON API
• SQS AWS JSONProtocolo da Amazon FAQs

Criar um endpoint

Para trabalhar com SQS filas da Amazon, você deve construir um endpoint. Para obter informações sobre SQS endpoints da Amazon, consulte as seguintes páginas no Referência geral da Amazon Web Services:

• Endpoints regionais

• Endpoints e cotas do Amazon Simple Queue Service

Cada SQS endpoint da Amazon é independente. Por exemplo, se duas filas forem nomeadas MyQueuee uma tiver o endpoint sqs.us-east-2.amazonaws.com enquanto a outra tiver o endpointsqs.eu-west-2.amazonaws.com, as duas filas não compartilharão dados entre si.

Veja a seguir um exemplo de endpoint que faz uma solicitação para criar uma fila.

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

nota

Os nomes das filas e as URLs filas diferenciam maiúsculas de minúsculas.

A estrutura do AUTHPARAMS depende da assinatura da API solicitação. Para obter mais informações, consulte AWS APISolicitações de assinatura na Referência geral da Amazon Web Services.

Fazendo uma POST solicitação

Uma SQS POST solicitação da Amazon envia parâmetros de consulta como um formulário no corpo de uma HTTP solicitação.

Veja a seguir um exemplo de um HTTP cabeçalho com X-Amz-Target definido como e um HTTP cabeçalho com Content-Type definido comoapplication/x-amz-json-1.0. AmazonSQS.<operationName>

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

Essa HTTP POST solicitação envia uma mensagem para uma SQS fila da Amazon.

nota

Ambos os HTTP X-Amz-Target cabeçalhos Content-Type são obrigatórios.

Seu HTTP cliente pode adicionar outros itens à HTTP solicitação, de acordo com a HTTP versão do cliente.