Criar ou atualizar entidade

Artigo
02/03/2024

Cria ou atualiza uma entidade de mensagens.

Solicitação

Método	URI da solicitação	Versão de 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 compartilhar os mesmos segmentos de prefixo.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização	Especifica um token SAS (Assinatura de Acesso Compartilhado) com direitos de "Gerenciar". Confira Autenticação do Barramento de Serviço com Assinaturas de Acesso Compartilhado para obter detalhes.
Tipo de conteúdo	Defina como application/atom+xml;type=entry;charset=utf-8.
If-Match	Defina esse cabeçalho como "*" para atualizar a entidade. Você deve fornecer todos os valores de propriedades desejados na entidade atualizada. Todos os valores que não forem fornecidos serão definidos com os valores padrão do serviço. Caso o cabeçalho esteja ausente, a chamada de atualização devolve um erro indicando que a entidade já existe.

Corpo da solicitação

O corpo da solicitação deve conter uma entrada Atom XML válida que insira 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 assinatura ou regra relativa a suas entidades pai.

Uma fila, por exemplo, é descrita com um QueueDescription elemento . O conteúdo XML para criar ou atualizar uma fila, portanto, pode assumir o seguinte formato, pelo qual todas as propriedades omitidas pressupõem seus valores padrão:

<?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>

Consulte a Visão geral para obter mais detalhes sobre entidades e como elas se relacionam com caminhos.

Resposta

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

Códigos de resposta

Observação

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

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

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

Nenhum.

Corpo da resposta

É retornada a descrição da entidade. Algumas propriedades da descrição podem conter valores padrão se estiverem ausentes da solicitação PUT.

Compartilhar via