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 do URI

Name	Em	Necessá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 um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	CapabilitiesListResult	O pedido foi bem-sucedido.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

GetCapabilities

Pedido de amostra

HTTP

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

Go

package armcontainerinstance_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerinstance/armcontainerinstance/v3"
)

// Generated from example definition: 2025-09-01/CapabilitiesList.json
func ExampleLocationClient_NewListCapabilitiesPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerinstance.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewLocationClient().NewListCapabilitiesPager("westus", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armcontainerinstance.LocationClientListCapabilitiesResponse{
		// 	CapabilitiesListResult: armcontainerinstance.CapabilitiesListResult{
		// 		Value: []*armcontainerinstance.Capabilities{
		// 			{
		// 				Capabilities: &armcontainerinstance.CapabilitiesCapabilities{
		// 					MaxCPU: to.Ptr[float32](4),
		// 					MaxGpuCount: to.Ptr[float32](4),
		// 					MaxMemoryInGB: to.Ptr[float32](14),
		// 				},
		// 				Gpu: to.Ptr("K80"),
		// 				IPAddressType: to.Ptr("Public"),
		// 				Location: to.Ptr("West US"),
		// 				OSType: to.Ptr("Linux"),
		// 				ResourceType: to.Ptr("containerGroups"),
		// 			},
		// 			{
		// 				Capabilities: &armcontainerinstance.CapabilitiesCapabilities{
		// 					MaxCPU: to.Ptr[float32](4),
		// 					MaxGpuCount: to.Ptr[float32](0),
		// 					MaxMemoryInGB: to.Ptr[float32](14),
		// 				},
		// 				Gpu: to.Ptr("None"),
		// 				IPAddressType: to.Ptr("Public"),
		// 				Location: to.Ptr("West US"),
		// 				OSType: to.Ptr("Windows"),
		// 				ResourceType: to.Ptr("containerGroups"),
		// 			},
		// 		},
		// 	},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:

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

Name	Description
Capabilities	As capacidades regionais.
CapabilitiesCapabilities	As capacidades suportadas.
CapabilitiesListResult	A resposta contendo lista de capacidades.
CloudError	Uma resposta de erro do serviço de Instância de Contêiner.
CloudErrorBody	Uma resposta de erro do serviço de Instância de Contêiner.

Capabilities

Object

As capacidades regionais.

Name	Tipo	Description
capabilities	CapabilitiesCapabilities	As capacidades suportadas.
gpu	string	O sku da GPU que esse recurso descreve.
ipAddressType	string	O tipo de endereço IP descrito por esse recurso.
location	string	A localização do recurso.
osType	string	O tipo de SO que esta funcionalidade descreve.
resourceType	string	O tipo de recurso que esse recurso descreve.

CapabilitiesCapabilities

Object

As capacidades suportadas.

Name	Tipo	Description
maxCpu	number (float)	A solicitação máxima de CPU 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

Object

A resposta contendo lista de capacidades.

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

CloudError

Object

Uma resposta de erro do serviço de Instância de Contêiner.

Name	Tipo	Description
error	CloudErrorBody	Uma resposta de erro do serviço de Instância de Contêiner.

CloudErrorBody

Object

Uma resposta de erro do serviço de Instância de Contêiner.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O alvo do erro específico. Por exemplo, o nome da propriedade em erro.