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

更新云服务

Update Cloud Service操作更新云服务的标签或说明。

请求

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

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

URI 参数

无。

请求标头

下表介绍请求标头。

请求标头	说明
Content-Type	必需。 将此标头设置为 application/xml。
x-ms-version	必需。 指定用于此请求的操作的版本。 此标头应设置为 2010-10-28 或更高版本。

请求正文

请求正文的格式如下所示：

<?xml version="1.0" encoding="utf-8"?>  
<UpdateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>    
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</UpdateHostedService>  

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

元素名称	说明
Label	如果指定了 Description，则可选。 为云服务指定 Base-64 编码的标识符。 标识符的长度最多是 100 个字符。 建议该标签在说明内唯一。 该标签可用于跟踪用途。
说明	如果指定了 Label，则可选。 指定云服务的说明。 说明的长度最多是 1024 个字符。
名称	可选。 指定某个扩展的云服务属性的名称。 必须为每个属性提供名称和值。 最多允许 50 个扩展属性。 名称的长度最多为 64 个字符。 名称中只有字母数字字符和下划线是有效字符，且必须以字母开头。 元素 Name 仅适用于版本 2012-03-01 或更高版本。
值	可选。 指定某个扩展的云服务属性的值。 每个扩展属性都必须有定义的名称和值。 值的长度最多是 255 个字符。 你可以通过将该值设置为 NULL，删除现有属性。 元素 Value 仅适用于版本 2012-03-01 或更高版本。
ReverseDnsFqdn	可选。 使用反向 DNS 查询进行查询时云服务的 IP 地址所解析成的 DNS 地址。 元素 ReverseDnsFqdn 仅适用于版本 2014-06-01 或更高版本。

响应

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

状态代码

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

响应标头

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

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

响应正文

无。