Get Subscription

Article
08/03/2016

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.

Share via