列出可用擴充功能

發行項
07/19/2023

List Available Extensions作業會列出可加入至雲端服務的擴充功能。在 Microsoft Azure 中，處理序可以當做雲端服務的延伸模組來執行。

要求

請使用下列格式指定 List Available Extensions 要求。使用您的訂用帳戶 ID 來取代 <subscription-id> 。

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

URI 參數

無。

要求標頭

下表描述要求標頭。

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

要求本文

無。

回應

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

狀態碼

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

回應標頭

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

回應標頭	Description
`x-ms-request-id`	唯一識別對管理服務發出之要求的值。

回應本文

下面範例會示範回應主體的格式：

  
<?xml version="1.0" encoding="utf-8"?>  
<ExtensionImages xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ExtensionImage>  
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
    <Type>type-of-extension</Type>      
    <Version>version-of-extension</Version>  
    <Label>label-of-extension</Label>  
    <Description>description-of-extension</Description>  
    <HostingResources>role-type</HostingResources>  
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
    <PublicConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PublicConfigurationSchema>  
    <PrivateConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PrivateConfigurationSchema>  
    <SampleConfig>base-64-encoded-sample-XML-for-extension</SampleConfig>  
    <ReplicationCompleted>indicator-of-replication-status</ReplicationCompleted>  
    <Eula> HYPERLINK "http://www.contoso.com/42588280809/eula%3c/Eula" eula-of-extension</Eula>  
    <PrivacyUri>privacy-policy-of-extension</PrivacyUri>  
    <HomepageUri>homepage-of-extension</HomepageUri>  
    <IsJsonExtension>indicator-of-JSON-support</IsJsonExtension>  
    <CompanyName>name-of-publishing-company</CompanyName>  
    <SupportedOS>supported-operating-system</SupportedOS>  
    <PublishedDate>publish-date-of-extension</PublishedDate>  
  </ExtensionImage>  
</ExtensionImages>

下表描述回應本文的元素。

元素名稱	Description
ProviderNameSpace	指定擴充功能的提供者命名空間。 Azure 擴充功能的提供者命名空間為 `Microsoft.WindowsAzure.Extensions`。
類型	指定擴充功能的類型。
版本	指定擴充功能的版本。
標籤	指定用以識別擴充功能的標籤。
Description	指定擴充功能的描述。
HostingResources	指定支援擴充功能的資源類型。這個值可以是 `WebRole`、`WorkerRole` 或 `WebRole\|WorkerRole`。
ThumbprintAlgorithm	指定用於加密的憑證指紋演算法。
PublicConfigurationSchema	指定公用組態的 base64 編碼結構描述。
PrivateConfigurationSchema	指定私用組態的 base64 編碼結構描述。
SampleConfig	為資源擴充功能指定範例組態檔。 SampleConfig 元素只能用於 2013-11-01 或更高版本。
ReplicationCompleted	指出是否已將延伸模組的版本複寫到所有地區。可能的值包括： - `true` - `false` 如果可使用延伸模組版本來建立或更新部署，則為 `true`；否則為 `false`，指出未準備好在所有地區中使用延伸模組的版本。必須使用 01.04.14 版或更高版本，才能使用 `ReplicationCompleted` 元素。
使用者授權合約	指定指向延伸模組版本之使用者授權合約 (EULA) 的 URI。必須使用 01.04.14 版或更高版本，才能使用 `Eula` 元素。
PrivacyUri	指定指向延伸模組版本之隱私權聲明的 URI。必須使用 01.04.14 版或更高版本，才能使用 `PrivacyUri` 元素。
HomepageUri	指定指向延伸模組版本之首頁的 URI。必須使用 01.04.14 版或更高版本，才能使用 `HomepageUri` 元素。
IsJsonExtension	指出延伸模組的版本是否接受 JSON 型組態。可能的值包括： - `true` - `false` 如果延伸模組接受 JSON 型組態，則為 `true`；否則為 `false`，且延伸模組接受 XML 型組態。必須使用 01.04.14 版或更高版本，才能使用 `IsJsonExtension` 元素。
CompanyName	指定發行延伸模組的公司名稱。元素 `CompanyName` 只能使用版本 2014-06-01 或更高版本。
SupportedOS	指定要執行延伸模組的作業系統。元素 `SupportedOS` 只能使用版本 2014-06-01 或更高版本。
PublishedDate	指定延伸模組的發行日期。元素 `PublishedDate` 只能使用版本 2014-06-01 或更高版本。

共用方式為