Share via

Location - List Usage

Service:
Container Instances
API Version:
2025-09-01

Get the usage for a subscription

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages?api-version=2025-09-01

URI Parameters

Name In Required Type Description
location
 path True

string

minLength: 1

The name of the Azure region.
subscriptionId
 path True

string (uuid)

The ID of the target subscription. The value must be an UUID.
api-version
 query True

string

minLength: 1

The API version to use for this operation.

Responses

Name Type Description
200 OK

UsageListResult

OK
Other Status Codes

CloudError

Error response describing why the operation failed.

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

ContainerUsage

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerInstance/locations/westcentralus/usages?api-version=2025-09-01

Sample response

Status code:
200 
{
  "value": [
    {
      "unit": "Count",
      "currentValue": 1,
      "limit": 2000,
      "name": {
        "value": "ContainerGroups",
        "localizedValue": "Container Groups"
      }
    }
  ]
}

Definitions

Name Description
CloudError

An error response from the Container Instance service.
CloudErrorBody

An error response from the Container Instance service.
Name

The name object of the resource
Usage

A single usage result
UsageListResult

The response containing the usage data

CloudError

Object

An error response from the Container Instance service.

Name Type Description
error

CloudErrorBody

An error response from the Container Instance service.

CloudErrorBody

Object

An error response from the Container Instance service.

Name Type Description
code

string

An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
details

CloudErrorBody[]

A list of additional details about the error.
message

string

A message describing the error, intended to be suitable for display in a user interface.
target

string

The target of the particular error. For example, the name of the property in error.

Name

Object

The name object of the resource

Name Type Description
localizedValue

string

The localized name of the resource
value

string

The name of the resource

Usage

Object

A single usage result

Name Type Description
currentValue

integer (int32)

The current usage of the resource
id

string

Id of the usage result
limit

integer (int32)

The maximum permitted usage of the resource.
name

Name

The name object of the resource
unit

string

Unit of the usage result

UsageListResult

Object

The response containing the usage data

Name Type Description
value

Usage[]

The usage data.