Get information about a cloud service

 

The Get information about a cloud service operation gets all the resources in a cloud service.

If you just want to know about the automation account resources in a cloud service, use the List automation accounts in a cloud service operation.

Request

To specify the request, replace <subscription-id> with your subscription ID, and <cloud-service-name> with a name of the cloud service to get.

Method

Request URI

GET

GET https://management.core.windows.net/<subscription-id>/cloudservices/<cloud-service-name>

Request Headers

The request header in the following table is required.

Request Header

Description

x-ms-version

Specifies the version of the operation. Set to 2013-06-01 or a later version.

Request Body

None.

Response

Status Code

An operation returns 200 (OK) for a successful operation. 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.

Response Body

The following XML shows a newly created cloud service with no resources defined.

<CloudService xmlns="https://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Name>CLSV1_Litware</Name>
  <Label>CLSV1_Litware</Label>
  <Description>Cloud Service for Litware.com</Description>
  <GeoRegion>East US</GeoRegion>
  <Resources />
</CloudService>

In this example, the XML shows a cloud service that contains two automation accounts.

<CloudService xmlns="https://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Name>CLSV2_Litware</Name>
  <Label>CLSV2_Litware</Label>
  <Description>Cloud Service #2 for Litware.com</Description>
  <GeoRegion>East US</GeoRegion>
  <Resources>
    <Resource>
      <ResourceProviderNamespace>automation</ResourceProviderNamespace>
      <Type>AutomationAccount</Type>
      <Name>DataCenter_BK</Name>
      <Plan/>
      <SchemaVersion>1.1</SchemaVersion>
      <ETag>922743be-a2e4-4137-8318-d8c69a3f136e</ETag>
      <State>Started</State>
      <SubState/>
      <IntrinsicSettings>
        <SubscriptionPlan >Free</SubscriptionPlan>
      </IntrinsicSettings>
      <OperationStatus>
        <Type>Create</Type>
        <Result>Succeeded</Result>
      </OperationStatus>
      <Label/>
    </Resource>
    <Resource>
      <ResourceProviderNamespace>automation</ResourceProviderNamespace>
      <Type>AutomationAccount</Type>
      <Name>DataCenter_NYC</Name>
      <Plan/>
      <SchemaVersion>1.1</SchemaVersion>
      <ETag>e6ea66ac-bbfb-44aa-8e16-f7d8280a8019</ETag>
      <State>Started</State>
      <SubState/>
      <IntrinsicSettings>
        <SubscriptionPlan >Free</SubscriptionPlan>
      </IntrinsicSettings>
      <OperationStatus>
        <Type>Create</Type>
        <Result>Succeeded</Result>
      </OperationStatus>
      <Label/>
    </Resource>
  </Resources>
</CloudService>

See Also

Automation Accounts
Automation Cloud Services
Operations on Automation