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

获取扩展

Get Extension操作检索有关已添加到云服务的指定扩展的信息。

请求

可以按以下方式指定 Get Extension 请求。 将 <subscription-id> 替换为你的订阅 ID，将 <cloudservice-name> 替换为云服务的名称，并将 <extensionId> 替换为在将扩展添加到云服务时分配给扩展的标识符。

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

URI 参数

无。

请求标头

下表介绍必需的和可选的请求标头。

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

请求正文

无。

响应

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

状态代码

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

响应标头

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

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

响应正文

以下示例显示响应正文的格式：

  
<?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>  
  <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>  
  

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

元素名称	说明
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 或更高版本中可用。