Create an automation account

 

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.

See Also

Automation Accounts
Operations on Automation