Criar ou Atualizar Entidade

Artigo
07/19/2023

Cria ou atualiza uma entidade de mensagens.

Pedir

Método	URI do pedido	Versão HTTP
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

O caminho da entidade pode ser um nome de vários segmentos, com segmentos separados por '/'. A totalidade do caminho compõe o nome das entidades. Várias entidades podem partilhar os mesmos segmentos de prefixo.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do Pedido	Description
Autorização	Especifica um token de Assinatura de Acesso Partilhado (SAS) com direitos de "Gerir". Veja Autenticação do Service Bus com Assinaturas de Acesso Partilhado para obter detalhes.
Content-Type	Definido como aplicação/atom+xml;type=entry; charset=utf-8.
If-Match	Defina este cabeçalho como "*" para atualizar a entidade. Tem de fornecer todos os valores de propriedade pretendidos na entidade atualizada. Os valores não fornecidos são definidos para os valores predefinidos do serviço. Se este cabeçalho estiver em falta, a chamada de atualização devolve um erro que indica que esta entidade já existe.

Corpo do Pedido

O corpo do pedido tem de conter uma entrada Atom XML válida que incorpore a descrição da entidade que deve ser criada

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>

Em que {description} descreveu uma Fila ou um Tópico para entidades de nível superior ou uma subscrição ou regra relativamente às entidades principais.

Uma fila, por exemplo, é descrita com um QueueDescription elemento. Por conseguinte, o payload XML para criar ou atualizar uma fila pode assumir o seguinte formulário, pelo que todas as propriedades omitidas assumem os respetivos valores predefinidos:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>

Veja a Descrição Geral para obter mais detalhes sobre as entidades e como se relacionam com os caminhos.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Códigos de Resposta

Nota

Se atualizar uma entidade com um nome que contenha carateres especiais ou codificados (por exemplo, "teste? Name=value&"), que é codificado para "test%3FName%3Dvalue%26"), será gerada uma exceção (401) não autorizada.

Código	Descrição
201	Entidade atualizada.
400	Corpo do pedido inválido.
401	Falha de autorização.
403	Quota excedida; entidade não atualizada.
500	Erro interno.

Para obter informações sobre códigos de estado, veja Códigos de Estado e Erro.

Cabeçalhos de Resposta

Nenhum.

Corpo da Resposta

A descrição da entidade é devolvida. Algumas propriedades de descrição podem conter valores predefinidos se estiverem em falta no pedido PUT.

Partilhar via