加入擴充功能

發行項
08/05/2023

Add Extension非同步作業會將可用的延伸模組加入至雲端服務。在 Microsoft Azure 中，處理序可以當做雲端服務的延伸模組來執行。

要求

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

方法	要求 URI
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions`

URI 參數

無。

要求標頭

下表描述要求標頭。

要求標頭	描述
`x-ms-version`	必要。指定用於這個要求的作業版本。此標頭應設定為 `2013-03-01` 或更新版本。

要求本文

下列範例示範要求主體的格式：

  
<?xml version="1.0" encoding="utf-8"?>  
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
  <Type>type-of-extension</Type>  
  <Id>identifier-of-extension</Id>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>  
  <Version>version-of-extension</Version>  
</Extension>

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

元素名稱	Description
ProviderNameSpace	必要。指定擴充功能的提供者命名空間。 Azure 擴充功能的提供者命名空間為 `Microsoft.Windows.Azure.Extensions`。
類型	必要。指定擴充功能的類型。
識別碼	必要。指定擴充功能的識別碼。
Thumbprint	選擇性。指定用於加密 `PrivateConfiguration` 中指定之組態的憑證指紋。如果未指定這個元素，可能會自動產生憑證並將其加入至雲端服務。
ThumbprintAlgorithm	選擇性。指定用於加密 `PrivateConfiguration` 中指定之組態的憑證指紋演算法。
PublicConfiguration	選擇性。指定使用清單可用擴充功能作業所傳回之架構所定義的公用組態。
PrivateConfiguration	選擇性。指定使用清單可用延伸模組作業所傳回之架構所定義的私用組態。
版本	選擇性。指定擴充功能的版本。如果這個元素並未指定或是使用星號 (``) 當做值，則會使用延伸模組的最新版本。如果指定此值時使用主要版本號碼和星號當做次要版本號碼 (`X.`)，則會選取指定之主要版本的最新次要版本。如果指定了主要版本號碼和次要版本號碼 (`X.Y`)，則會選取指定的擴充功能版本。如果指定某個版本，則會針對角色執行個體執行自動升級。

回應

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

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

回應標頭

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。

回應標頭	Description
`x-ms-request-id`	唯一識別對管理服務發出之要求的值。針對非同步作業，您可以使用標頭的值呼叫取得作業狀態，以判斷作業是否已完成、失敗或仍在進行中。

回應本文

無。

共用方式為