Location - List Capabilities

Serviço:

Container Instances

Versão da API:

2025-09-01

Obtenha a lista de recursos do local.
Obtenha a lista de recursos de CPU/memória/GPU de uma região.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
location	path	True	string minLength: 1	O nome da região do Azure.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	CapabilitiesListResult	A solicitação foi bem-sucedida.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

GetCapabilities

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:

200

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

Definições

Nome	Description
Capabilities	Os recursos regionais.
CapabilitiesCapabilities	As capacidades suportadas.
CapabilitiesListResult	A resposta que contém a lista de recursos.
CloudError	Uma resposta de erro do serviço instância de contêiner.
CloudErrorBody	Uma resposta de erro do serviço instância de contêiner.

Capabilities

Objeto

Os recursos regionais.

Nome	Tipo	Description
capabilities	CapabilitiesCapabilities	As capacidades suportadas.
gpu	string	O sku de GPU que essa funcionalidade descreve.
ipAddressType	string	O tipo de endereço ip que essa funcionalidade descreve.
location	string	O local do recurso.
osType	string	O tipo de sistema operacional que essa funcionalidade descreve.
resourceType	string	O tipo de recurso que essa funcionalidade descreve.

CapabilitiesCapabilities

Objeto

As capacidades suportadas.

Nome	Tipo	Description
maxCpu	number (float)	A solicitação de CPU máxima permitida em núcleos.
maxGpuCount	number (float)	A contagem máxima de GPU permitida.
maxMemoryInGB	number (float)	A solicitação de memória máxima permitida em GB.

CapabilitiesListResult

Objeto

A resposta que contém a lista de recursos.

Nome	Tipo	Description
nextLink	string	A URL para obter o próximo conjunto de resultados.
value	Capabilities[]	A lista de recursos.

CloudError

Objeto

Uma resposta de erro do serviço instância de contêiner.

Nome	Tipo	Description
error	CloudErrorBody	Uma resposta de erro do serviço instância de contêiner.

CloudErrorBody

Objeto

Uma resposta de erro do serviço instância de contêiner.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.