Criar ou atualizar entidade

  • Artigo

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.