导出 (0) 打印
全部展开

添加扩展

更新时间: 2014年4月

Add Extension 操作向您的云服务添加可用扩展。在 Windows Azure 中,进程可作为云服务的扩展运行。例如,远程桌面访问或 Windows Azure 诊断代理可作为云服务的扩展运行。可以使用列出可用扩展操作查找可用扩展。

可以按以下方式指定 Add Extension 请求。将 <subscription-id> 替换为您的订阅 ID,将 <cloudservice-name> 替换为云服务的名称。

 

方法 请求 URI HTTP 版本

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

HTTP/1.1

无。

下表介绍请求标头。

 

请求标头 说明

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>
Important重要提示
请求正文中的元素顺序非常重要。如果元素是必需的,它必须按以上所示的顺序显示在 XML 中。

下表介绍了请求正文中的主要元素:

 

元素名称 说明

必需。ProviderNameSpace

指定扩展的提供程序命名空间。Windows Azure 扩展的提供程序命名空间是 Microsoft.Windows.Azure.Extensions

Type

必需。指定扩展的类型。

Id

必需。指定扩展的标识符。

Thumbprint

可选。指定证书的指纹,该证书用于加密在 PrivateConfiguration 中指定的配置。如果未指定此元素,可能自动生成一个证书并将它添加到云服务。

ThumbprintAlgorithm

可选。指定证书的指纹算法,该证书用于加密在 PrivateConfiguration 中指定的配置。

PublicConfiguration

可选。指定使用列出可用扩展操作返回的架构定义的公共配置。

PrivateConfiguration

可选。指定使用列出可用扩展操作返回的架构定义的私有配置。

Version

可选。指定扩展的版本。如果未指定此元素或值为星号 (*),则使用扩展的最新版本。如果使用主版本号和作为次版本号的星号指定该值 (X.*),则选择指定主版本的最新次版本。如果指定主版本号和次版本号 (X.Y),则选择特定扩展版本。如果指定版本,将对角色实例执行自动升级。

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

此操作成功后返回状态代码 200(正常)。有关状态代码的信息,请参阅服务管理状态和错误代码

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范

 

响应标头 说明

x-ms-request-id

一个值,它唯一地标识对管理服务做出的请求。对于异步操作,可调用 Get Operation Status 配合标头值以确定操作已完成、失败还是仍在进行中。有关详细信息,请参阅跟踪异步服务管理请求

无。

可使用任何与 <subscription-id> 指定的订阅关联的管理证书对此操作进行身份验证。有关其他详细信息,请参阅对服务管理请求进行身份验证

显示:
© 2014 Microsoft