Create an automation account

Article
11/20/2015

The Create an automation account operation creates an automation account with a specified name.

Request

To specify the request, replace <subscription-id> with your subscription ID, <cloud-service-name> with the name of the cloud service to use for making the request, and <automation-account-name> with the name of the automation account to create. Include required URI parameters.

This operation does not return a response body. To see the automation account you created, see List automation accounts in a cloud service.

Method	Request URI
PUT	https://management.core.windows.net/<subscription-id>/cloudServices/<cloud-service-name>/resources/automation/AutomationAccount/<automation-account-name>?resourceType=AutomationAccount&detailLevel=Full&resourceProviderNamespace=automation

URI Parameters

Uri Parameter	Description
resourceType	Required. Specify "AutomationAccount".
detailLevel	Required. Specify "Full".
resourceProviderNamespace	Required. Specify "automation".

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 automation account whose name is specified in the request URI.

<Resource xmlns="https://schemas.microsoft.com/windowsazure"> 
  <CloudServiceSettings> 
    <GeoRegion>North US</GeoRegion> 
  </CloudServiceSettings> 
  <SchemaVersion>1.0</SchemaVersion> 
  <Plan>Gold</Plan> 
</Resource>

Request Body Element	Description
GeoRegion	The geographic region of the resource. The resource must be built in this region and this cannot be changed once it is created.
SchemaVersion	The current version of the schema.
Plan	The plan tier of the automation account.

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 x-ms-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

Response 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.

Share via