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

创建云服务

项目
08/05/2023

Create Cloud Service异步操作在 Microsoft Azure 中创建新的云服务。

请求

按如下所示指定 Create Cloud Service 请求。将 <subscription-id> 替换为订阅 ID。

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

URI 参数

无。

请求标头

下表介绍请求标头。

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

请求正文

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

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

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

元素名称	说明
ServiceName	必需。指定云服务的名称。此名称在 Azure 中必须是唯一的。此名称是用于访问该服务的 DNS 前缀名称。若要验证名称的可用性，可以使用检查云服务名称可用性。
Label	必需。指定云服务的 Base-64 编码的标识符。标识符的长度最多是 100 个字符。该标签可用于跟踪用途。
说明	可选。指定云服务的说明。说明的长度最多是 1024 个字符。
位置	如果未指定 `AffinityGroup`，则是必需的。指定创建云服务的位置。必须指定 `Location` 或 `AffinityGroup`，但不能同时指定两者。若要查看可用位置，可以使用 “列出位置”。
AffinityGroup	如果未指定 `Location`，则是必需的。指定与订阅相关联的现有地缘组的名称。必须指定 `Location` 或 `AffinityGroup`，但不能同时指定两者。若要查看可用的地缘组，可以使用列出地缘组。
名称	可选。指定某个扩展的云服务属性的名称。名称最长可以是 64 个字符，只有字母数字字符和下划线在名称中有效，并且名称必须以字母开头。每个扩展属性都必须有定义的名称和值。最多可以定义 50 个扩展属性。元素 `Name` 仅适用于版本 2012-03-01 或更高版本。
值	可选。指定某个扩展的云服务属性的值。扩展属性值的长度最多是 255 个字符。元素 `Value` 仅适用于版本 2012-03-01 或更高版本。
ReverseDnsFqdn	可选。使用反向 DNS 查询进行查询时云服务的 IP 地址所解析成的 DNS 地址。元素 `ReverseDnsFqdn` 仅适用于版本 2014-06-01 或更高版本。

响应

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

状态代码

此操作成功后返回状态代码 201（已创建）。

响应标头

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

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

响应正文

无。

通过