Create a cloud service
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
None.
See Also
Automation Accounts
Automation Cloud Services
Operations on Automation