Location - List Capabilities

Get the list of capabilities of the location.
Get the list of CPU/memory/GPU capabilities of a region.

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

URI Parameters

Name In Required Type Description
location
path True

string

The identifier for the physical azure location.

subscriptionId
path True

string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

api-version
query True

string

Client API version

Responses

Name Type Description
200 OK

CapabilitiesListResult

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

GetCapabilities

Sample request

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.ContainerInstance/locations/westus/capabilities?api-version=2023-05-01

Sample response

{
  "value": [
    {
      "resourceType": "containerGroups",
      "osType": "Linux",
      "location": "West US",
      "ipAddressType": "Public",
      "gpu": "K80",
      "capabilities": {
        "maxMemoryInGB": 14,
        "maxCpu": 4,
        "maxGpuCount": 4
      }
    },
    {
      "resourceType": "containerGroups",
      "osType": "Windows",
      "location": "West US",
      "ipAddressType": "Public",
      "gpu": "None",
      "capabilities": {
        "maxMemoryInGB": 14,
        "maxCpu": 4,
        "maxGpuCount": 0
      }
    }
  ]
}

Definitions

Name Description
Capabilities

The regional capabilities.

CapabilitiesListResult

The response containing list of capabilities.

CloudError

An error response from the Container Instance service.

CloudErrorBody

An error response from the Container Instance service.

Capabilities

The regional capabilities.

Name Type Description
capabilities

Capabilities

The supported capabilities.

gpu

string

The GPU sku that this capability describes.

ipAddressType

string

The ip address type that this capability describes.

location

string

The resource location.

osType

string

The OS type that this capability describes.

resourceType

string

The resource type that this capability describes.

CapabilitiesListResult

The response containing list of capabilities.

Name Type Description
nextLink

string

The URI to fetch the next page of capabilities.

value

Capabilities[]

The list of capabilities.

CloudError

An error response from the Container Instance service.

Name Type Description
error

CloudErrorBody

An error response from the Container Instance service.

CloudErrorBody

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.