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

添加扩展

Add Extension异步操作向云服务添加可用扩展。 在 Microsoft Azure 中，进程可作为云服务的扩展运行。

请求

可以按以下方式指定 Add Extension 请求。 请将 <subscription-id> 替换为你的订阅 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>  

下表说明了请求正文的元素。

元素名称	说明
ProviderNameSpace	必需。 指定扩展的提供程序命名空间。 Azure 扩展的提供程序命名空间是 Microsoft.Windows.Azure.Extensions。
类型	必需。 指定扩展的类型。
ID	必需。 指定扩展的标识符。
Thumbprint	可选。 指定证书的指纹，该证书用于加密在 PrivateConfiguration 中指定的配置。 如果未指定此元素，可能自动生成一个证书并将它添加到云服务。
ThumbprintAlgorithm	可选。 指定证书的指纹算法，该证书用于加密在 PrivateConfiguration 中指定的配置。
PublicConfiguration	可选。 指定使用 “列出可用扩展 ”操作返回的架构定义的公共配置。
PrivateConfiguration	可选。 指定使用 “列出可用扩展 ”操作返回的架构定义的专用配置。
版本	可选。 指定扩展的版本。 如果未指定此元素或将星号 (*) 用作值，则将使用扩展的最新版本。 如果使用主版本号和作为次版本号的星号指定该值 (X.*)，则选择指定主版本的最新次版本。 如果指定主版本号和次版本号 (X.Y)，则选择特定扩展版本。 如果指定版本，将对角色实例执行自动升级。

响应

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

状态代码

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

响应标头

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

响应标头	说明
x-ms-request-id	一个值，它唯一地标识对管理服务做出的请求。 对于异步操作，可以使用 标头的值调用 “获取操作状态” ，以确定操作是已完成、已失败还是仍在进行中。

响应正文

无。