Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

SubscribedSku

Updated: May 26, 2015

Important: the content in this topic may be out of date. See the new interactive Graph API documentation for the most up-to-date reference documentation for Azure AD Graph API. With the interactive documentation, you can try REST operations against a sample tenant from inside the documentation itself. Documentation updates are only being made in the interactive documentation, and this topic will be removed in the future.

Applies To: Azure AD Graph

This topic provides descriptions of the declared properties and navigation properties of the SubscribedSku entity type, as well as the operations, actions, and functions that you can call on it. Only the read operation is supported on subscribed SKUs; create, update, and delete are not supported.

Namespace: Microsoft.DirectoryServices for version 1.5 and newer, Microsoft.WindowsAzure.ActiveDirectory for versions prior to 1.5.

Base type: DirectoryObject

The SubscribedSku entity has the following properties:

Declared Properties

Property

Type

Read

Description

capabilityStatus

Edm.String

Yes

consumedUnits

Edm.Int32

Yes

objectId

Edm.String

Yes

Notes: key, not nullable

prepaidUnits

LicenseUnitsDetail

Yes

servicePlans

Collection(ServicePlanInfo)

Yes

Notes: not nullable

skuId

Edm.Guid

Yes

skuPartNumber

Edm.String

Yes

For information about the primitive types exposed by the EDM, see Entity Data Model: Primitive Data Types.

The following table shows how to address the subscribed SKU resource set, which spans all the subscribed SKUs in the directory, and how to address an individual subscribed SKU. The examples in the table use the tenant domain to address the tenant. For other ways of addressing the tenant, see Addressing Entities and Operations in the Graph API.

 

Artifact URL fragment Example

Resource Set (all subscribed SKUs)

/subscribedSkus

https://graph.windows.net/contoso.onmicrosoft.com/subscribedSkus?api-version=1.5

Individual subscribed SKU

/subscribedSku/{objectId}

https://graph.windows.net/contoso.onmicrosoft.com/subscribedSku/12345678-9abc-def0-1234-56789abcde?api-version=1.5

noteNote
Subscribed SKUs can also be addressed as generic directory objects by replacing “subscribedSkus” with “directoryObjects” in the URL.

For more comprehensive information about querying directory objects, see Azure AD Graph API Common Queries and Azure AD Graph API Differential Query.

The following operations are supported on subscribed SKUs (the HTTP method used for each is in parentheses):

  • Read (GET)

Subscribed SKUs do not expose any navigation properties. No functions or actions may be called on subscribed SKUs.

The principal that performs the operation must be in an administrator role that has permissions to read subscribed SKU objects to send GET requests.

  • You cannot create, delete, or update subscribed SKUs using the Graph API.

  • Query filter expressions are not supported on subscribed SKUs.

See Also

Show:
© 2015 Microsoft