Get Subscription

  • Article

 

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

Request

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>

URI Parameters

None.

Request Headers

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.

Request Body

None.

Response

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

Status Code

A successful operation returns status code 200 (OK).

Response Headers

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.

Response Body

The format for the response body is as follows:

<Subscription xmlns=https://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.