Todos os produtos
Search
Central de documentação

:CreateBinding

Última atualização: Jul 08, 2026

Cria um binding para vincular uma fila ou um exchange a um exchange específico.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimCreateBinding

A operação a ser executada. Defina o valor como

CreateBinding.

ArgumentStringSimx-match:all;type:report;format:pdf

Pares chave-valor configurados para os atributos headers de uma mensagem. Concatene um ou mais pares chave-valor para definir esses atributos. O atributo x-match deve assumir um dos valores válidos listados abaixo, enquanto os demais são personalizáveis. Valores válidos para x-match:

  • all: Um exchange do tipo headers roteia a mensagem para a fila apenas se todos os atributos de binding da fila (exceto x-match) corresponderem aos atributos headers da mensagem. Este é o valor padrão.
  • any: Um exchange do tipo headers roteia a mensagem para a fila se pelo menos um atributo de binding da fila (exceto x-match) corresponder aos atributos headers da mensagem.

Separe os atributos com ponto e vírgula (;) e use dois pontos (:) entre a chave e o valor de cada atributo. Exemplo: x-match:all;type:report;format:pdf.

Este parâmetro aplica-se apenas a exchanges do tipo headers. Para outros tipos de exchange, defina-o com qualquer valor arbitrário.

BindingKeyStringSim.test

A chave de binding.

  • Se o exchange de origem não for do tipo topic, configure a chave de binding conforme os requisitos abaixo:
    • A chave de binding pode conter apenas letras, dígitos, hifens (-), underscores (_), pontos (.), barras (/) e arrobas (@).
    • A chave de binding deve ter de 1 a 255 caracteres.
  • Se o exchange de origem for do tipo topic, configure a chave de binding conforme os requisitos abaixo:
    • A chave de binding pode conter letras, dígitos, hifens (-), underscores (_), pontos (.), cerquilhas (#), barras (/) e arrobas (@).
    • Caso contenha uma cerquilha (#), ela deve aparecer sempre acompanhada de um ponto (.). A chave deve começar com cerquilha seguida de ponto (#.) e terminar com ponto seguido de cerquilha (.#).
    • A chave de binding deve ter de 1 a 255 caracteres.
BindingTypeStringSim0

O tipo de objeto a ser vinculado ao exchange de origem. Valores válidos:

  • 0: vincula uma fila ao exchange de origem
  • 1: vincula um exchange ao exchange de origem
DestinationNameStringSimDemoQueue

Nome do objeto a ser vinculado ao exchange de origem. Esse objeto deve ter sido criado no console.

InstanceIdStringSimamqp-cn-v0h1kb9nu***

O ID da instância.

RegionIdStringSimcn-hangzhou

O ID da região.

SourceExchangeStringSimNormalEX

Nome do exchange de origem. O exchange deve ter sido criado no console.

VirtualHostStringSimtest

Nome do vhost. O vhost deve ter sido criado no console.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

09768C14-E51C-4F4A-8077-30810032C***

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateBinding
&Argument=x-match:all;type:report;format:pdf 
&BindingKey=.test
&BindingType=0
&DestinationName=DemoQueue
&InstanceId=amqp-cn-v0h1kb9nu***
&RegionId=cn-hangzhou
&SourceExchange=NormalEX
&VirtualHost=test
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<CreateBindingResponse>
      <RequestId>09768C14-E51C-4F4A-8077-30810032C***</RequestId>
</CreateBindingResponse>

Formato JSON

{
    "RequestId":"09768C14-E51C-4F4A-8077-30810032C***"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.