匯出 (0) 列印
全部展開
本主題尚未接受評分 - 為這個主題評分

變更部署組態

更新日期: 2014年4月

Change Deployment Configuration 作業會起始部署組態的變更。

Change Deployment Configuration 作業是非同步作業。若要判斷管理服務是否已完成要求的處理,請呼叫 取得作業狀態。如需有關非同步作業的詳細資訊,請參閱<追蹤非同步服務管理要求>。

請使用下列格式指定 Change Deployment Configuration 要求。請注意,您可以指定部署環境 (預備或生產),或指定部署的唯一名稱,藉此變更部署的組態。

若要產生要求 URI,請以您的訂用帳戶 ID 取代 <subscription-id>、以雲端服務的名稱取代 <cloudservice-name>、以 <deployment-slot>staging 取代 production,並且以部署的唯一名稱取代 <deployment-name>

 

方法 要求 URI HTTP 版本

POST

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

HTTP/1.1

POST

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

HTTP/1.1

 

URI 參數 說明

comp=config

必要項。指定必須對部署的組態進行變更。

下表描述要求標頭。

 

要求標頭 說明

Content-Type

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

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭應該設定為 2009-10-01 或更新版本。如需有關版本設定標頭的詳細資訊,請參閱<服務管理版本設定>。

要求主體的格式如下:


<?xml version="1.0" encoding="utf-8"?>
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">
  <Configuration>base-64-encoded-configuration-file</Configuration>
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>
  <Mode>type-of-change</Mode>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>property-name</Name>
      <Value>property-value</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
      </Extension>
      ...
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
          ...
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</ChangeConfiguration>

Important重要事項
要求主體中元素的順序十分重要。如果需要某個元素,它在 XML 中出現的順序必須如上所示。

下表描述要求主體中的重要元素:

 

元素名稱 說明

Configuration

必要項。指定部署的 Base-64 編碼服務組態檔。

TreatWarningsAsError

(選擇性)。指出是否應將警告視為錯誤。

可能的值為:

  • true

  • false

若未指定,預設值是 false。如果設定為 true,就會在遇到警告時封鎖更新。

必須使用 2011-04-01 版或更高版本,才能使用 TreatWarningsAsError 元素。

Mode

選擇項。可能的值為:

  • Auto

  • Manual

  • Simultaneous

若未指定,預設值是 Auto。如果設定為 Manual,就必須呼叫 WalkUpgradeDomain 以套用更新。如果設定為 Auto,便會對服務的每個更新網域自動套用更新。

必須使用 2011-08-01 版或更高版本,才能使用 Mode 元素。

必須使用 2012-12-01 或更高版本,才能使用 Simultaneous 設定。

Name

(選擇性)。代表擴充雲端服務屬性的名稱。每個擴充屬性都必須具有已定義的名稱和值。您最多可以擁有 25 個擴充屬性名稱和值組。

Name 元素的長度上限為 64 個字元、只有英數字元和底線可用於名稱,而且名稱必須以字母當做開頭。如果您嘗試使用其他字元、以非字母字元當做開頭,或者輸入的名稱與相同雲端服務所擁有之其他擴充屬性的名稱完全相同,就會產生狀態碼 400 (不正確的要求) 錯誤。

必須使用 2012-03-01 版或更高版本,才能使用 Name 元素。

Value

(選擇性) 代表擴充雲端服務屬性的值。每個擴充屬性都必須具有已定義的名稱和值。您最多可以擁有 25 個擴充屬性名稱和值組,而且每個擴充屬性值的長度上限為 255 個字元。

您可以將此值設定為 NULL,藉以刪除擴充屬性。

必須使用 2012-03-01 版或更高版本,才能使用 Value 元素。

ExtensionConfiguration

(選擇性) 代表加入至雲端服務的擴充功能。在 Windows Azure 中,處理序可以當做雲端服務的擴充功能來執行。例如,遠端桌面存取或 Windows Azure 診斷代理程式可以當做雲端服務的擴充功能來執行。您必須先使用 加入擴充功能 將擴充功能加入至雲端服務,該擴充功能在組態變更期間才能加入至部署。

必須使用 2013-03-01 版或更高版本,才能使用 ExtensionConfiguration 元素。

代表加入至雲端服務的擴充功能。

 

元素名稱 說明

AllRoles

(選擇性) 指定套用至部署中所有角色的擴充功能清單。

擴充功能

必要項。代表要部署至雲端服務中之角色的擴充功能。

NamedRoles

(選擇性) 指定套用至部署中特定角色的擴充功能清單。

代表要部署至雲端服務中之角色的擴充功能。

 

元素名稱 說明

Id

必要項。擴充功能的識別碼。此識別碼是在擴充功能加入至雲端服務時建立的。您可以使用 列出擴充功能 來尋找已加入至雲端服務之擴充功能的 Id。

指定套用至部署中特定角色的擴充功能清單。

 

元素名稱 說明

Role

必要項。代表加入擴充功能的特定角色。

RoleName

必要項。指定角色的名稱。

擴充功能

必要項。代表要部署至雲端服務中之角色的擴充功能。

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

因為 Change Deployment Configuration 是非同步作業,所以您必須呼叫 取得作業狀態 來判斷此作業已完成、失敗,還是仍在進行中。

因為 Change Deployment Configuration 是非同步作業,所以它一律會傳回狀態碼 202 (接受)。若要判斷此作業的狀態碼,請在作業完成之後,呼叫 取得作業狀態。狀態碼會內嵌在此作業的回應中。如果成功,狀態碼將會是 200 (OK)。如需狀態碼的資訊,請參閱<服務管理狀態和錯誤碼>。

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

 

回應標頭 說明

x-ms-request-id

唯一識別對管理服務發出之要求的值。若為非同步作業,您可以使用標頭的值來呼叫 Get Operation Status,以便判斷作業已完成、失敗,還是仍在進行中。如需詳細資訊,請參閱<追蹤非同步服務管理要求>。

無。

<subscription-id> 指定之訂用帳戶相關聯的任何管理憑證都可用來驗證此作業。如需其他詳細資訊,請參閱<驗證服務管理要求>。

無。

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2014 Microsoft. 著作權所有,並保留一切權利。