你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建或更新实体

项目
02/12/2024

创建或更新消息传送实体。

请求

方法	请求 URI	HTTP 版本
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

实体路径可以是多段名称，段以“/”分隔。整个路径构成实体的名称。多个实体可以共享相同的前缀段。

请求标头

下表介绍必需的和可选的请求标头。

请求标头	说明
授权	指定具有“管理”权限 (SAS) 令牌的共享访问签名。有关详细信息，请参阅使用共享访问签名进行服务总线身份验证。
Content-Type	设置为 application/atom+xml;type=entry;charset=utf-8。
If-Match	将此标头设置为“*”可更新实体。你必须提供已更新实体上所需的所有属性值。任何未提供的值将设置为服务默认值。如果此标头缺失，则更新调用将返回错误，指示该实体已存在。

请求正文

请求的正文必须包含有效的 Atom XML 条目，该条目嵌入应创建的实体的说明

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

其中，{description} 描述了顶级实体的队列或主题，或者相对于其父实体的订阅或规则。

例如，使用元素描述 QueueDescription 队列。因此，用于创建或更新队列的 XML 有效负载可能采用以下形式，即所有省略的属性都假定其默认值：

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

有关实体及其与路径的关系的更多详细信息，请参阅概述。

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

注意

如果使用包含特殊或编码字符的名称更新实体， (例如，“test？Name=value&“) ，编码为”test%3FName%3Dvalue%26“) ，将生成 (401) 未经授权的异常。

代码	说明
201	实体已更新。
400	请求正文无效。
401	授权失败。
403	已超出配额；未更新实体。
500	内部错误。

有关状态代码的信息，请参阅状态和错误代码。

响应标头

无。

响应正文

返回实体描述。如果 PUT 请求中缺少部分描述属性，则这些属性可能包含默认值。

通过