List all cloud services

The List all cloud services operation gets all the cloud services in a subscription. This helps you determine if you have already created a cloud service or if you need to create a new one. This is also needed if you want to enumerate your resources.

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

Request

To specify the request, replace <subscription-id> with your subscription ID.

Method	Request URI
GET	https://management.core.windows.net/<subscription-id>/cloudservices

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. Use this value to determine the current status of an asynchronous operation.

Response Body

The following XML shows multiple cloud services.

<?xml version="1.0" encoding="utf-8"?>
<CloudServices xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <CloudService>
    <Name>CachingLitware-East-US</Name>
    <Label>CachingLitware-East-US</Label>
    <Description>Data Center caching for Litware</Description>
    <GeoRegion>East US</GeoRegion>
    <Resources>
      <Resource>
        <ResourceProviderNamespace>cacheservice</ResourceProviderNamespace>
        <Type>Caching</Type>
        <Name>elvgcache</Name>
        <ETag>34d78dd7-b1bd-4316-9c46-e3faa140827c</ETag>
        <State>NotFound</State>
        <OutputItems>
          <OutputItem>
            <Key>CreationDate</Key>
            <Value>6/16/2014 5:44:12 PM +00:00</Value>
          </OutputItem>
        </OutputItems>
        <OperationStatus>
          <Type>Create</Type>
          <Result>Succeeded</Result>
        </OperationStatus>
      </Resource>
    </Resources>
  </CloudService>
  <CloudService>
    <Name>CLSV1_Litware</Name>
    <Label>CLSV1_Litware</Label>
    <Description>Cloud Service for Litware.com</Description>
    <GeoRegion>East US</GeoRegion>
    <Resources/>
  </CloudService>
  <CloudService>
    <Name>CLSV2_Litware</Name>
    <Label>CLSV2_Litware</Label>
    <Description>Cloud Service #2 for Litware.com</Description>
    <GeoRegion>East US</GeoRegion>
    <Resources/>
  </CloudService>
  <CloudService>
    <Name>CLSV3_Litware</Name>
    <Label>CLSV2_Litware</Label>
    <Description>Cloud Service #3 for Litware.com</Description>
    <GeoRegion>East US</GeoRegion>
    <Resources/>
  </CloudService>
  <CloudService>
    <Name>CLSV4_Litware</Name>
    <Label>CLSV4_Litware</Label>
    <Description>Cloud Service #4 for Litware.com</Description>
    <GeoRegion>East US</GeoRegion>
    <Resources/>
  </CloudService>
 </CloudServices>

Element	Description
Name	Name of the cloud service.
Label	Label for the cloud service.
Description	Description of the cloud service.
GeoRegion	Geographical region of the cloud service
nextLink	Returned only when the number of records exceeds the page size (100 records). This link, and any subsequent links, returns the next page of records.