你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
创建云服务
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 |
一个值，它唯一地标识对管理服务做出的请求。 对于异步操作，可以使用标头的值调用 “获取操作状态” ，以确定操作是完成、已失败还是仍在进行中。 |
响应正文
无。