Create a cloud service

Article
01/06/2016

The Create a cloud service operation creates a new cloud service. When automation accounts are created, they are hosted within a cloud service. A cloud service groups automation accounts together for a given region. After a cloud service has been created, automation accounts can then be created and contained within it.

Request

To specify the request, replace <subscription-id> with your subscription ID, and <cloud-service-name> with a name for the new cloud service.

Method	Request URI
PUT	https://management.core.windows.net/<subscription-id>/cloudServices/<cloud-service-name>

URI Parameters

None.

Request Headers

The request headers in the following table are required.

Request Header	Description
Content-Type	Set to application/xml.
x-ms-version	Specifies the version of the operation. Set to 2013-06-01 or a later version.

Request Body

The following XML fragment defines the cloud service whose name is specified in the request URI.

<CloudService xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/windowsazure">
      <Label>CLSV1_Litware</Label>
      <Description>Cloud Service for Litware.com</Description>
      <GeoRegion>East US</GeoRegion>
</CloudService>

Element	Description
Label	The name of the cloud service.
Description	The description of the cloud service.
GeoRegion	Specifies the location of the data center where the service is hosted.

Response

Status Code

An operation returns 202 (Accepted) for an asynchronous operation. Use the Get Operation Status operation to determine its current status. You’ll need the request ID that was returned in the response.

For information about common error codes, see Service Management Status and Error Codes. For all error codes, see HTTP/1.1 Status Code Definitions.

Response Headers

Request Header	Description
x-ms-request-id	A unique identifier for the current operation. Use this value to determine the current status of an asynchronous operation.

Response Body