As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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
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:
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
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.AUTHPARAMS
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.