匯出 (0) 列印
全部展開

更新雲端服務

更新日期: 2014年5月

Update Cloud Service 作業可以更新雲端服務的標籤或描述。

請使用下列格式指定 Update Cloud Service 要求。請以您的訂閱 ID 取代 <subscription-id>,並以雲端服務的名稱取代 <cloudservice-name>

 

方法 要求 URI

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>

您必須確定對管理服務發出的要求是安全的。如需其他詳細資訊,請參閱驗證服務管理要求

無。

下表描述要求標頭。

 

要求標頭 描述

Content-Type

必要項。將此標頭設定為 application/xml

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭應該設定為 2010/10/28 或更高版本。如需版本設定標頭的詳細資訊,請參閱服務管理版本設定

要求主體的格式如下:

<?xml version="1.0" encoding="utf-8"?>
<UpdateHostedService xmlns="http://schemas.microsoft.com/windowsazure">
  <Label>base64-encoded-label-of-cloud-service</Label>
  <Description>description-of-cloud-service</Description>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>name-of-property</Name>
      <Value>value-of-property</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <GuestAgentType>type-of-guest-agent</GuestAgentType
</UpdateHostedService>

下表說明要求主體的元素。

 

元素名稱 描述

Label

在已指定「描述」的情況下為選擇性。指定雲端服務的 Base-64 編碼識別項。識別項的長度最多可達 100 個字元。建議讓標籤成為訂閱中的唯一標籤。此標籤可讓您用來進行追蹤。

描述

在已指定「標籤」的情況下為選擇性。指定雲端服務的描述。描述的長度最多可達 1024 個字元。

名稱

選擇性。指定雲端服務擴充屬性的名稱。您必須為每一個屬性提供名稱和值。允許的擴充屬性數目上限是 50 個。名稱的長度最多可達 64 個字元。名稱中只能使用英數字元和底線,而且名稱必須以字母開頭。

必須使用 2012/3/1 版或更高版本,才能使用 Name 元素。

選擇性。指定雲端服務擴充屬性的值。每個擴充屬性都必須具有已定義的名稱和值。值的長度最多可達 255 個字元。您可以將值設定為 NULL,藉此刪除現有的屬性。

必須使用 2012/3/1 版或更高版本,才能使用 Value 元素。

GuestAgentType

選擇性。指定安裝於 Web 角色和背景工作角色部署上的客體代理程式的類型。

可能的值為:

  • ProdGA

  • TestGA

GuestAgentType 是有限制性的元素,僅供設定為獲得授權可提早存取未來客體代理程式版本的訂閱使用。當 GuestAgentType 設定為 ProdGA 時,將會在雲端服務中的 Web 角色和背景工作角色執行個體上安裝已公開發行的最新版客體代理程式。如果 GuestAgentType 設定為 TestGA,則會安裝最新測試版的客體代理程式。

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

成功的作業會傳回狀態碼 200 (確定)。如需狀態碼的資訊,請參閱<服務管理狀態和錯誤碼>。

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格

 

回應標頭 描述

x-ms-request-id

唯一識別對管理服務發出之要求的值。

無。

顯示:
© 2014 Microsoft