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

Lista as instâncias de um serviço especificado.

Descrição da operação

Certifique-se de compreender os métodos de cobrança e os preços do Elastic Algorithm Service (EAS) antes de chamar esta operação.

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:ListServiceInstances

get

*Service

acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}

Nenhuma

Sintaxe da solicitação

GET /api/v2/services/{ClusterId}/{ServiceName}/instances HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID da região na qual o serviço está implantado.	cn-shanghai
ServiceName	string	Sim	O nome do serviço. Para obter mais informações, consulte ListServices.	foo

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PageNumber	integer	Não	O número da página. O valor padrão é 1.	1
PageSize	integer	Não	O número de entradas a serem retornadas em cada página. O valor padrão é 100.	20
Filter	string	Não	Uma palavra-chave para a pesquisa. Você pode pesquisar por nome da instância, endereço IP da instância, endereço IP do host ou tipo de instância.	10.118.xx.xx
ResourceType	string	Não	O tipo do grupo de recursos ao qual a instância de serviço pertence. Valores válidos: PublicResource : Grupo de recursos público. DedicatedResource : Grupo de recursos dedicado.	PublicResource
InstanceType	string	Não	O tipo da instância.	ecs.c7.large
InstanceStatus	string	Não	O status da instância de serviço.	Running
InstanceIP	string	Não	O endereço IP da instância de serviço.	10.224.xx.xx
InstanceName	string	Não	O nome da instância de serviço.	foo-bdc5xxxx-8l7rk
HostIP	string	Não	O endereço IP do host no qual a instância de serviço está implantada.	10.224.xx.xx
IsSpot	boolean	Não	Especifica se a instância é uma instância spot.	false
Role	string	Não	A função do serviço. Valores válidos: DataSet : Serviço de conjunto de dados. SDProxy : Serviço de proxy do Stable Diffusion. Standard : Serviço de previsão padrão. Queue : Serviço de fila.	Queue
Sort	string	Não	O campo a ser usado para classificação. Valores válidos: StartTime : Hora de criação.	StartTime
Order	string	Não	A ordem de classificação. Valores válidos: asc : Ascendente. desc : Descendente.	desc
MemberType	string	Não	O tipo do subserviço. Este parâmetro é válido apenas para serviços de agregação.	LLMDecode
ListReplica	boolean	Não	Especifica se a lista de réplicas da instância deve ser consultada.	true
ReplicaName	string	Não	O nome da réplica da instância.	cbh-qwen3-a1bc-prefill-ep1tp4dp
QuotaId	string	Não	O ID da cota.	quota1****
Resource	string	Não	O grupo de recursos ao qual a instância pertence.	eas-r-xxxxxxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	40325405-579C-4D82****
Instances	array	A lista de instâncias de serviço.
	Instance	A instância de serviço.
PageNumber	integer	O número da página retornada.	1
PageSize	integer	O número de entradas retornadas por página.	20
TotalCount	integer	O número total de instâncias.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "40325405-579C-4D82****",
  "Instances": [
    {
      "HostIP": "11.0.XX.XX",
      "HostName": "smart-scene-cls-854dbdc99d-****",
      "InnerIP": "172.17.0.17",
      "InstanceName": "foo-5fc8946767-v****",
      "InstancePort": 8080,
      "LastState": [
        []
      ],
      "Namespace": "foo",
      "Reason": "RUNNING",
      "RestartCount": 1,
      "Status": "Running",
      "TotalProcesses": 1,
      "ReadyProcesses": 1,
      "StartAt": "2021-05-27T09:46:05Z",
      "Role": "Standard",
      "ResourceType": "PublicResource",
      "TenantInstanceIP": "192.168.xx.xx",
      "TenantHostIP": "192.168.xx.xx",
      "IsSpot": false,
      "CurrentAmount": 0.444,
      "OriginalAmount": 2.2,
      "Isolated": false,
      "Zone": "cn-shanghai-a",
      "ExternalIP": "192.168.1.100",
      "ExternalInstancePort": 8080,
      "StartTime": "2021-05-27T09:46:05Z",
      "InstanceType": "ecs.c7.large",
      "IsLatest": true,
      "Detached": false,
      "IsReplica": false,
      "ReplicaName": "xwq-sglang-dist-7dff0",
      "CreateTime": "2021-05-27T09:46:05Z"
    }
  ],
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 1
}

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.