Create Cloud Service
Create Cloud Service asynchronous operation creates a new cloud service in Microsoft Azure.
Create Cloud Service request is specified as follows. Replace
<subscription-id> with your subscription ID.
The following table describes the request headers.
||Required. Set this header to
||Required. Specifies the version of the operation to use for this request. The value of this header must be set to
The format of the request body is as follows:
<?xml version="1.0" encoding="utf-8"?> <CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure"> <ServiceName>name-of-cloud-service</ServiceName> <Label>base64-encoded-label-of-cloud-service</Label> <Description>description-of-cloud-service</Description> <Location>location-of-cloud-service</Location> <AffinityGroup>name-of-affinity-group</AffinityGroup> <ExtendedProperties> <ExtendedProperty> <Name>name-of-property</Name> <Value>value-of-property</Value> </ExtendedProperty> </ExtendedProperties> <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn> </CreateHostedService>
The following table describes the elements of the request body.
|ServiceName||Required. Specifies the name for the cloud service. This name must be unique within Azure. This name is the DNS prefix name that is used to access the service. To verify the availability of a name, you can use Check Cloud Service Name Availability.|
|Label||Required. Specifies the base-64-encoded identifier of the cloud service. The identifier can be up to 100 characters long. The label can be used for your tracking purposes.|
|Description||Optional. Specifies the description of the cloud service. The description can be up to 1024 characters long.|
You must specify
|Name||Optional. Specifies the name of an extended cloud service property. The name can be up to 64 characters long, only alphanumeric characters and underscores are valid in the name, and it must start with a letter. Each extended property must have both a defined name and value. You can define a maximum of 50 extended properties.
|Value||Optional. Specifies the value of an extended cloud service property. The extended property value can be up to 255 characters long.
|ReverseDnsFqdn||Optional. Specifies the DNS address to which the IP address of the cloud service resolves when queried using a reverse DNS query.
The response includes an HTTP status code and a set of response headers.
A successful operation returns status code 201 (Created).
The response for this operation includes the following headers. The response may also include additional standard HTTP headers.
||A value that uniquely identifies a request made against the management service. For an asynchronous operation, you can call Get Operation Status with the value of the header to determine whether the operation is complete, has failed, or is still in progress.|