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

列出扩展

List Extensions 操作列出已添加到云服务的所有扩展。

请求

可以按以下方式指定 List Extensions 请求。请将 <subscription-id> 替换为你的订阅 ID，将 <cloudservice-name> 替换为云服务的名称。

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

URI 参数

无。

请求标头

下表介绍请求标头。

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

请求正文

无。

响应

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

状态代码

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

响应标头

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

响应标头	说明
`x-ms-request-id`	一个值，它唯一地标识对管理服务做出的请求。

响应正文

以下示例显示请求正文的格式：

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

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

元素名称	说明
ProviderNameSpace	扩展的提供程序命名空间。 Microsoft Azure 扩展的提供程序命名空间是 `Microsoft.Windows.Azure.Extensions`。
类型	必需。扩展的类型。
ID	扩展的标识符。
版本	扩展的版本。
Thumbprint	证书的指纹，该证书用于加密在 `PrivateConfiguration` 中指定的配置。如果未指定此元素，可能自动生成一个证书并将它添加到云服务。
ThumbprintAlgorithm	证书的指纹算法，该证书用于加密在 `PrivateConfiguration` 中指定的配置。
PublicConfiguration	使用 “列出可用扩展 ”操作返回的架构定义的公共配置。
IsJsonExtension	指示扩展配置是否支持 JSON。可能的值包括： - `true` - `false` 元素 `IsJsonExtension` 仅在版本 2014-06-01 或更高版本中可用。
DisallowMajorVersionUpgrade	指示扩展是否支持自动升级到新的主要版本。元素 `DisallowMajorVersionUpgrade` 仅在版本 2014-06-01 或更高版本中可用。

Last updated on 2023-08-05