Frequently asked questions in Azure Stack usage API
This article answers some frequently asked questions about the Azure Stack Usage API.
What meter IDs can I see?
Currently, usage is reported for the network, storage, and compute resource providers.
|Resource provider||Meter ID||Meter name||Unit||Additional info|
|Network||F271A8A388C44D93956A063E1D2FA80B||Static IP Address Usage||IP addresses||Count of IP addressess used|
|9E2739BA86744796B465F64674B822BA||Dynamic IP Address Usage||IP addresses||Count of IP addressess used|
|Storage||B4438D5D-453B-4EE1-B42A-DC72E377F1E4||TableCapacity||GB*hours||Total capacity consumed by tables|
|B5C15376-6C94-4FDD-B655-1A69D138ACA3||PageBlobCapacity||GB*hours||Total capacity consumed by page blobs|
|B03C6AE7-B080-4BFA-84A3-22C800F315C6||QueueCapacity||GB*hours||Total capacity consumed by queue|
|09F8879E-87E9-4305-A572-4B7BE209F857||BlockBlobCapacity||GB*hours||Total capacity consumed by block blobs|
|B9FF3CD0-28AA-4762-84BB-FF8FBAEA6A90||TableTransactions||Request count in 10,000s||Table service requests (in 10,000s)|
|50A1AEAF-8ECA-48A0-8973-A5B3077FEE0D||TableDataTransIn||Ingress data in GB||Table service data ingress in GB|
|1B8C1DEC-EE42-414B-AA36-6229CF199370||TableDataTransOut||Outgress in GB||Table service data egress in GB|
|43DAF82B-4618-444A-B994-40C23F7CD438||BlobTransactions||Requests count in 10,000s||Blob service requests (in 10,000s)|
|9764F92C-E44A-498E-8DC1-AAD66587A810||BlobDataTransIn||Ingress data in GB||Blob service data ingress in GB|
|3023FEF4-ECA5-4D7B-87B3-CFBC061931E8||BlobDataTransOut||Outgress in GB||Blob service data egress in GB|
|EB43DD12-1AA6-4C4B-872C-FAF15A6785EA||QueueTransactions||Requests count in 10,000s||Queue service requests (in 10,000s)|
|E518E809-E369-4A45-9274-2017B29FFF25||QueueDataTransIn||Ingress data in GB||Queue service data ingress in GB|
|DD0A10BA-A5D6-4CB6-88C0-7D585CEF9FC2||QueueDataTransOut||Outgress in GB||Queue service data egress in GB|
|Compute||FAB6EB84-500B-4A09-A8CA-7358F8BBAEA5||Base VM Size Hours||Virtual core minutes||Number of vcores times minutes the VM ran|
|9CD92D4C-BAFD-4492-B278-BEDC2DE8232A||Windows VM Size Hours||Virtual core minutes||Number of vcores times minutes the VM ran|
|6DAB500F-A4FD-49C4-956D-229BB9C8C793||VM size hours||VM hours||Captures both Base and Windows VM. Does not adjust for vcores|
|Key Vault||EBF13B9F-B3EA-46FE-BF54-396E93D48AB4||Key Vault transactions||Request count in 10000s||Number of REST API requests received by Key Vault data plane|
How do the Azure Stack usage APIs compare to the Azure usage API (currently in public preview)?
- The Tenant Usage API is consistent with the Azure API, with one exception: the showDetails flag currently is not supported in Azure Stack.
- The Provider Usage API applies only to Azure Stack.
- Currently, the RateCard API that is available in Azure is not available in Azure Stack.
What is the difference between usage time and reported time?
Usage data reports have two main time values:
- Reported Time. The time when the usage event entered the usage system
- Usage Time. The time when the Azure Stack resource was consumed
You might see a discrepancy in values for Usage Time and Reported Time for a specific usage event. The delay can be as long as multiple hours in any environment.
Currently, you can query only by Reported Time.
What do these usage API error codes mean?
|HTTP status code||Error code||Description|
|400/Bad Request||NoApiVersion||The api-version query parameter is missing.|
|400/Bad Request||InvalidProperty||A property is missing or has an invalid value. The message in the error code in the response body identifies the missing property.|
|400/Bad Request||RequestEndTimeIsInFuture||The value for ReportedEndTime is in the future. Values in the future are not allowed for this argument.|
|400/Bad Request||SubscriberIdIsNotDirectTenant||A provider API call used a subscription ID that is not a valid tenant of the caller.|
|400/Bad Request||SubscriptionIdMissingInRequest||The subscription ID of the caller is missing.|
|400/Bad Request||InvalidAggregationGranularity||An invalid aggregation granularity was requested. Valid values are daily and hourly.|
|503||ServiceUnavailable||A retryable error occurred because the service is busy or the call is being throttled.|