Compartilhar via


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