Usages - List By Location

Gets the current usage count and the limit for the resources of the location under the subscription.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Storage/locations/{location}/usages?api-version=2023-05-01

URI Parameters

Name In Required Type Description
location
path True

string

The location of the Azure Storage resource.

subscriptionId
path True

string

The ID of the target subscription.

api-version
query True

string

The API version to use for this operation.

Responses

Name Type Description
200 OK

UsageListResult

OK -- current usage count and limit retrieved and returned successfully.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

UsageList

Sample request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Storage/locations/eastus2(stage)/usages?api-version=2023-05-01

Sample response

{
  "value": [
    {
      "unit": "Count",
      "currentValue": 55,
      "limit": 250,
      "name": {
        "value": "StorageAccounts",
        "localizedValue": "Storage Accounts"
      }
    }
  ]
}

Definitions

Name Description
Usage

Describes Storage Resource Usage.

UsageListResult

The response from the List Usages operation.

UsageName

The usage names that can be used; currently limited to StorageAccount.

UsageUnit

Gets the unit of measurement.

Usage

Describes Storage Resource Usage.

Name Type Description
currentValue

integer

Gets the current count of the allocated resources in the subscription.

limit

integer

Gets the maximum count of the resources that can be allocated in the subscription.

name

UsageName

Gets the name of the type of usage.

unit

UsageUnit

Gets the unit of measurement.

UsageListResult

The response from the List Usages operation.

Name Type Description
value

Usage[]

Gets or sets the list of Storage Resource Usages.

UsageName

The usage names that can be used; currently limited to StorageAccount.

Name Type Description
localizedValue

string

Gets a localized string describing the resource name.

value

string

Gets a string describing the resource name.

UsageUnit

Gets the unit of measurement.

Name Type Description
Bytes

string

BytesPerSecond

string

Count

string

CountsPerSecond

string

Percent

string

Seconds

string