你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

列出扩展版本

List Extension Versions 操作列出可添加到云服务的扩展的版本。 在 Microsoft Azure 中，进程可作为云服务的扩展运行。

请求

可以按以下方式指定 List Extension Versions 请求。 将 替换为订阅 ID，<provider-namespace>将 替换为<subscription-id>扩展的命名空间，将 <type> 替换为扩展的类型。

方法	请求 URI
GET	https://management.core.windows.net/<subscription-id>/services/extensions/<provider-namespace>/<type>

URI 参数

无。

请求标头

下表介绍请求标头。

请求标头	说明
x-ms-version	必需。 指定用于此请求的操作的版本。 此标头应设置为 2013-03-01 或更高版本。

请求正文

无。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

此操作成功后返回状态代码 200（正常）。

响应标头

此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。

响应标头	说明
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>  
  

下表介绍响应正文的元素。

元素名称	说明
ProviderNameSpace	指定扩展的提供程序命名空间。 Microsoft Azure 扩展的提供程序命名空间是 Microsoft.WindowsAzure.Extensions。
类型	指定扩展的类型。
版本	指定扩展的主版本和次版本。
Label	指定用于标识扩展的标签。
说明	指定扩展的说明。
HostingResources	指定支持扩展的资源类型。 此值可为 WebRole、WorkerRole 或 WebRole|WorkerRole。
ThumbprintAlgorithm	指定用于加密的证书的指纹算法。
PublicConfigurationSchema	指定公共配置的 Base64 编码的架构。
PrivateConfigurationSchema	指定私有配置的 Base64 编码的架构。
SampleConfig	指定资源扩展的示例配置文件。 仅 2013-11-01 或更高版本才能使用 SampleConfig 元素。
ReplicationCompleted	指示是否已将扩展的版本复制到所有区域。 可能的值包括： - true - false 如果扩展版本可用于创建或更新部署，则为 true；否则为 false，指示扩展版本未准备好在所有区域中使用。 仅在 01.04.14 或更高版本中才可以使用 ReplicationCompleted 元素。
Eula	指定一个指向扩展版本的最终用户许可协议 (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 或更高版本。