DescribeResource - Platform For AI: Central de Documentação do Alibaba Cloud

Obtém os detalhes de um grupo de recursos.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eas:DescribeResource

get

*Resource

acs:eas:{#regionId}:{#accountId}:resource/{#ResourceId}

Nenhuma

Sintaxe da solicitação

GET /api/v2/resources/{ClusterId}/{ResourceId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster que contém o grupo de recursos.	cn-shanghai
ResourceId	string	Sim	O ID do grupo de recursos. Chame ListResources para obter esse ID.	eas-r-asdasdasd

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes do grupo de recursos.
RequestId	string	O ID da solicitação.	902976F2-6FAF-5404-8A4D-6CC223***
ResourceId	string	O ID do grupo de recursos.	eas-r-glkfpsxuw57x1h*****
ResourceName	string	O nome do grupo de recursos.	my-resouce****
ClusterId	string	O ID do cluster que contém o grupo de recursos.	cn-beijing
CreateTime	string	A hora em que o grupo de recursos foi criado.	2020-05-19T14:19:42Z
UpdateTime	string	A hora em que o grupo de recursos foi atualizado pela última vez.	2021-02-24T11:52:17Z
OwnerUid	string	O ID do proprietário do grupo de recursos.	14401087478****
InstanceCount	integer	O número total de instâncias no grupo de recursos.	4
PrePaidInstanceCount	integer	O número total de instâncias pré-pagas no grupo de recursos.	1
PostPaidInstanceCount	integer	O número total de instâncias pós-pagas no grupo de recursos.	3
ServiceCount	string	O número de serviços implantados no grupo de recursos.	1
CpuCount	integer	O número total de núcleos de CPU.	16
GpuCount	integer	O número total de GPUs.	4
Memory	integer	O tamanho total da memória, em MB.	8192
CpuUsed	integer	O número de núcleos de CPU em uso.	8
GpuUsed	number	O número de GPUs em uso.	2
MemoryUsed	integer	A quantidade de memória em uso, em MB.	2048
Status	string	O status do grupo de recursos.	ResourceReady
Message	string	Uma mensagem que fornece detalhes sobre o status do grupo de recursos.	Resource is ready
ExtraData	string	Informações adicionais, como o status da conexão VPC e o status do log SLS.	{"vswitch_id":"vsw-bp17uo6xebcusy**","gpu_share":true,"aux_vswitch_id_list":["vsw-bp13b3pvjap3vxn","vsw-bp1nls8o5hk8mt8*"],"security_group_id":"sg-bp1j1z7297hcink*","vpc_id":"vpc-bp1kjr3rfyhx01*","destination_cidr":"172.16.0.12/28","role_arn":"acs:ram::1157703270***:role/AliyunServiceRoleForPaiEas","sls_project":"","sls_logstore":"","sls_status":"ResourceReady","sls_message":"","update_time":""}
ResourceType	string	O tipo do grupo de recursos. Valores válidos: `Dedicated`: um grupo de recursos dedicado. `SelfManaged`: um grupo de recursos autogerenciado. Valores válidos: SelfManaged : SelfManaged. Dedicated : Dedicated.	Dedicated
UsageMode	string	O modo de uso do grupo de recursos. Valores válidos: inference : Um grupo de recursos para serviços de inferência. sandbox : Um grupo de recursos para sandboxes.	inference
InstanceMaxAllocatableMemory	integer	A quantidade máxima de memória que pode ser alocada para uma única instância no grupo de recursos, em MB.	2048
Features	array	As funcionalidades que o grupo de recursos suporta.
	string	Uma funcionalidade que o grupo de recursos suporta. Atualmente, apenas `GpuShare` (compartilhamento de GPU) é suportado.	GpuShare
InstanceMaxAllocatableGPU	number	O número máximo de GPUs que podem ser alocadas para uma única instância no grupo de recursos.	2
InstanceMaxAllocatableCPU	integer	O número máximo de núcleos de CPU que podem ser alocados para uma única instância no grupo de recursos.	16

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "902976F2-6FAF-5404-8A4D-6CC223***",
  "ResourceId": "eas-r-glkfpsxuw57x1h*****",
  "ResourceName": "my-resouce****",
  "ClusterId": "cn-beijing",
  "CreateTime": "2020-05-19T14:19:42Z",
  "UpdateTime": "2021-02-24T11:52:17Z",
  "OwnerUid": "14401087478****",
  "InstanceCount": 4,
  "PrePaidInstanceCount": 1,
  "PostPaidInstanceCount": 3,
  "ServiceCount": "1",
  "CpuCount": 16,
  "GpuCount": 4,
  "Memory": 8192,
  "CpuUsed": 8,
  "GpuUsed": 2,
  "MemoryUsed": 2048,
  "Status": "ResourceReady",
  "Message": "Resource is ready",
  "ExtraData": "{\"vswitch_id\":\"vsw-bp17uo6xebcusy****\",\"gpu_share\":true,\"aux_vswitch_id_list\":[\"vsw-bp13b3pvjap3vxn****\",\"vsw-bp1nls8o5hk8mt8*****\"],\"security_group_id\":\"sg-bp1j1z7297hcink*****\",\"vpc_id\":\"vpc-bp1kjr3rfyhx01*****\",\"destination_cidr\":\"172.16.0.12/28\",\"role_arn\":\"acs:ram::1157703270*****:role/AliyunServiceRoleForPaiEas\",\"sls_project\":\"\",\"sls_logstore\":\"\",\"sls_status\":\"ResourceReady\",\"sls_message\":\"\",\"update_time\":\"\"}",
  "ResourceType": "Dedicated",
  "UsageMode": "inference",
  "InstanceMaxAllocatableMemory": 2048,
  "Features": [
    "GpuShare"
  ],
  "InstanceMaxAllocatableGPU": 2,
  "InstanceMaxAllocatableCPU": 16
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.