建立或更新實體

建立或更新傳訊實體。

要求

方法	要求 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>  

Whereby {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 要求中遺漏了這些屬性)。