建立雲端服務
Create Cloud Service 非同步作業會在 Microsoft Azure 中建立新的雲端服務。
要求
要求 Create Cloud Service 指定如下。 使用您的訂用帳戶 ID 來取代 <subscription-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>
下表說明要求主體的元素。
| 元素名稱 | Description |
|---|---|
| ServiceName | 必要。 指定雲端服務的名稱。 此名稱在 Azure 中必須是唯一的。 這個名稱是供用以存取服務的 DNS 首碼名稱。 若要確認名稱的可用性，您可以使用 檢查雲端服務名稱可用性。 |
| 標籤 | 必要。 指定雲端服務的 Base-64 編碼識別項。 識別項的長度最多可達 100 個字元。 此標籤可讓您用來進行追蹤。 |
| 描述 | 選擇性。 指定雲端服務的描述。 描述的長度最多可達 1024 個字元。 |
| 位置 | 如果沒有指定 AffinityGroup，則為必要項目。 指定雲端服務建立所在的位置。您必須指定 Location 或 AffinityGroup，但不能兩者並存。 若要查看可用的位置，您可以使用 清單位置。 |
| AffinityGroup | 如果沒有指定 Location，則為必要項目。 指定與訂閱相關聯之現有同質群組的名稱。 您必須指定 Location 或 AffinityGroup，但不能兩者並存。 若要查看可用的同質群組，您可以使用 清單同質群組。 |
| 名稱 | 選擇性。 指定雲端服務擴充屬性的名稱。 名稱的長度最多可達 64 個字元、只有英數字元和底線可用於名稱，而且名稱必須以字母當做開頭。 每個擴充屬性都必須具有已定義的名稱和值。 您最多可以定義 50 個擴充屬性。 只在使用 01.03.12 版或更高版本，才能使用 Name 元素。 |
| 值 | 選擇性。 指定雲端服務擴充屬性的值。 擴充屬性值的長度最多可達 255 個字元。 只在使用 01.03.12 版或更高版本，才能使用 Value 元素。 |
| ReverseDnsFqdn | 選擇性。 指定在使用反向 DNS 進行查詢時，雲端服務的 IP 位址所解析成的 DNS 位址。 元素 ReverseDnsFqdn 只能使用版本 2014-06-01 或更高版本。 |
回應
回應包括 HTTP 狀態碼和一組回應標頭。
狀態碼
成功的作業會傳回狀態碼「201 (已建立)」。
回應標頭
這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。
| 回應標頭 | Description |
|---|---|
x-ms-request-id |
唯一識別對管理服務發出之要求的值。 針對非同步作業，您可以使用標頭的值呼叫 取得作業狀態 ，以判斷作業是否已完成、失敗或仍在進行中。 |
回應本文
無。