Get Subscription

 

Updated: July 10, 2015

The Get Subscription operation returns account and resource allocation information for the specified subscription.

The Get Subscription request may be specified as follows. Replace <subscription-id> with the subscription ID.

Method

Request URI

GET

https://management.core.windows.net/<subscription-id>

The following table describes the request headers.

Request Header

Description

x-ms-version

Required. Specifies the version of the operation to use for this request. This header must be set to 2011-10-01 or higher.

The response includes an HTTP status code, a set of response headers, and a response body.

A successful operation returns status code 200 (OK).

The response for this operation includes the following headers. The response may also include additional standard HTTP headers.

Response Header

Description

x-ms-request-id

A value that uniquely identifies a request made against the management service.

The format for the response body is as follows:


<Subscription xmlns=http://schemas.microsoft.com/windowsazure   xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <SubscriptionID>subscription-id</SubscriptionID>
  <SubscriptionName>name-of-the-subscription</SubscriptionName>
  <SubscriptionStatus>Active</SubscriptionStatus>
  <AccountAdminLiveEmailId>account-admin-live-id</AccountAdminLiveEmailId>
  <ServiceAdminLiveEmailId>service-admin-live-id</ServiceAdminLiveEmailId>
  <MaxCoreCount>maximum-cores-allocable</MaxCoreCount>
  <MaxStorageAccounts>maximum-storage-accounts-allocable</MaxStorageAccounts>
  <MaxHostedServices>maximum-hosted-services-allocable</MaxHostedServices>
  <CurrentCoreCount>currently-allocated-cores</CurrentCoreCount>
  <CurrentHostedServices>currently-allocated-hosted-services</CurrentHostedServices>
  <CurrentStorageAccounts>currently-allocated-storage-accounts</CurrentStorageAccounts>
  <MaxVirtualNetworkSites>maximum-virtual-network-sites-allocable</MaxVirtualNetworkSites>
  <CurrentVirtualNetworkSites>currently-allocated-virtual-network-sites</CurrentVirtualNetworkSites>
  <MaxLocalNetworkSites>maximum-local-virtual-network-sites-allocable</MaxLocalNetworkSites>
  <CurrentNetworkSecurityGroupCount>currently-allocated-network-security-groups</CurrentNetworkSecurityGroupCount>
  <MaxNetworkSecurityGroupCount>maximum-network-security-groups</MaxNetworkSecurityGroupCount>
  <MaxNetworkSecurityRulesPerGroupCount>maximum-network-security-rules-per-group</MaxNetworkSecurityRulesPerGroupCount>
  <CurrentLocalNetworkSites>currently-allocated-local-network-sites</CurrentLocalNetworkSites>
  <MaxDnsServers>maximum-dns-servers-allocable</MaxDnsServers>
  <AADTenantID>active-directory-tenant-identifier</AADTenant>
  <CreatedTime>creation-time-of-subscription</CreatedTime> 
</Subscription>

The following table describes the elements of the response body.

Element name

Description

SubscriptionID

Specifies the identifier of the subscription.

SubscriptionName

Specifies the name of the subscription.

SubscriptionStatus

Specifies the status of the subscription.

Possible values are:

  • Active

  • Disabled

AccountAdminLiveEmailId

Specifies the live ID of the account administrator.

ServiceAdminLiveEmailId

Specifies the live ID of the subscription administrator.

MaxCoreCount

Specifies the maximum number of cores that can be allocated in the subscription.

MaxStorageAccounts

Specifies the maximum number of storage accounts that can be allocated in the subscription.

MaxHostedServices

Specifies the maximum number of cloud services that can be allocated in the subscription.

CurrentCoreCount

Specifies the number of currently allocated cores.

CurrentHostedServices

Specifies the number of currently allocated cloud services.

CurrentStorageAccounts

Specifies the number of currently allocated storage accounts.

MaxVirtualNetworkSites

Specifies the maximum number of virtual network sites that can be allocated in the subscription.

CurrentVirtualNetworkSites

Specifies the number of currently allocated virtual network sites.

MaxLocalNetworkSites

Specifies the maximum number of local virtual network sites that can be allocated in the subscription.

CurrentNetworkSecurityGroupCount

Specifies the number of currently allocated network security groups.

MaxNetworkSecurityGroupCount

Specifies the maximum number of network security groups.

MaxNetworkSecurityRulesPerGroupCount

Specifies the maximum number of network security rules per group.

CurrentLocalNetworkSites

Specifies the number of currently allocated local network sites.

MaxDnsServers

Specifies he maximum number of DNS servers that can be allocated in the subscription.

AADTenantID

Specifies the Azure Active Directory tenant that is associated with the subscription.

CreatedTime

Specifies the time that the subscription was created.

Show: