Todos os produtos
Search
Central de documentação

Platform For AI:ListServices

Última atualização: Jul 08, 2026

Lista serviços.

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

get

*Service

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

Nenhuma Nenhuma

Sintaxe da solicitação

GET /api/v2/services HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Sort

string

Não

O campo de ordenação. Por padrão, os resultados são ordenados por timestamp em ordem decrescente.

CreateTime

Order

string

Não

A ordem de classificação. Valores válidos:

  • desc (padrão): decrescente.

  • asc: crescente.

asc

Filter

string

Não

A palavra-chave para busca aproximada. Este parâmetro suporta buscas aproximadas apenas por nome de serviço.

foo

PageNumber

integer

Não

O número da página dos resultados a serem retornados. O valor padrão é 1.

1

PageSize

integer

Não

O número de serviços a serem retornados por página. O valor padrão é 100.

100

GroupName

string

Não

O nome do grupo de serviços. Para saber como obter esse nome, consulte ListServices.

foo

ParentServiceUid

string

Não

O UID do serviço primário. Este parâmetro se aplica a serviços membros em um grupo de serviços.

eas-m-ijafy3c8cxxxx

ServiceType

string

Não

O tipo de serviço. Valores válidos:

  • Async

  • Standard

  • Queue

  • LLM

  • RAG

  • Serverless

  • LLMGatewayService

  • OfflineTask

  • SDCluster

  • ScalableJob

  • ScalableJobService

  • AssistantJob

Valores válidos:

  • Async :

    serviço assíncrono.

  • Standard :

    implantação padrão.

  • OfflineTask :

    tarefa offline.

  • Proxima :

    Proxima

Standard

Label

object

Não

Filtra serviços por label.

string

Não

Especifique a label no formato {"key":"value"}. Se o valor for null ou uma string vazia, o sistema filtra apenas pela chave.

{"key1":"value1","key2":null}

ServiceStatus

string

Não

O status do serviço.

Valores válidos:

  • Creating :

    Creating.

  • Stopped :

    Stopped.

  • Failed :

    Failed.

  • Complete :

    Complete.

  • Cloning :

    Cloning.

  • Stopping :

    Stopping.

  • Updating :

    Updating.

  • Waiting :

    Waiting.

  • HotUpdate :

    HotUpdate.

  • Committing :

    Committing.

  • Starting :

    Starting.

  • DeleteFailed :

    DeleteFailed.

  • Running :

    Running.

  • Developing :

    Developing.

  • Scaling :

    Scaling.

  • Deleted :

    Deleted.

  • Pending :

    Pending.

  • Deleting :

    Deleting.

Running

ServiceName

string

Não

O nome do serviço.

echo_test

ServiceUid

string

Não

O UID do serviço.

eas-m-c9iw3yitxxxx

ResourceName deprecated

string

Não

O nome ou ID do grupo de recursos do serviço.

eas-r-hd0qwy8cxxxx

WorkspaceId

string

Não

O ID do workspace.

1234**

QuotaId

string

Não

O ID da cota.

quota1****

Gateway

string

Não

O ID do gateway privado.

gw-1uhcqmsc7x22******

Role

string

Não

A função do serviço.

Valores válidos:

  • DataLoader :

    DataLoader.

  • FrontEnd :

    FrontEnd.

  • DataSet :

    DataSet.

  • SDProxy :

    SDProxy.

  • LLMScheduler :

    LLMScheduler.

  • ScalableJob :

    ScalableJob.

  • LLMGateway :

    LLMGateway.

  • Job :

    Job.

  • Queue :

    Queue.

LLMGateway

ResourceType

string

Não

O tipo de recurso que o serviço utiliza. Valores válidos:

  • PublicResource

  • DedicatedResource

  • Lingjun

  • SelfManagedLingjun

Valores válidos:

  • Lingjun :

    cota de recursos Lingjun.

  • PublicResource :

    grupo de recursos públicos.

  • DedicatedResource :

    grupo de recursos dedicados.

  • SelfManagedLingjun :

    grupo de recursos Lingjun autogerenciado.

PublicResource

IncludeNoWorkspace

boolean

Não

Especifica se devem ser incluídos serviços que não pertencem a nenhum workspace. O valor padrão é true.

true

ResourceAliasName

string

Não

O nome personalizado do grupo de recursos.

example

ResourceId

string

Não

O ID do grupo de recursos. Para saber como consultar esse ID, consulte ListResources.

eas-r-asdas****

ResourceBurstable

boolean

Não

Especifica se deve ser ativado um pool de recursos com capacidade de burst para o serviço.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

CronscalerEnabled

boolean

Não

Especifica se o auto scaling programado deve ser ativado para o serviço.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

AutoscalerEnabled

boolean

Não

Especifica se o Auto Scaling deve ser ativado para o serviço.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

TrafficState

string

Não

Especifica se o serviço aceita tráfego de grupo. Este parâmetro se aplica apenas a serviços dentro de um grupo de serviços.

Valores válidos:

  • standalone :

    No

  • grouping :

    Sim.

grouping

CallerUid

string

Não

O UID da conta que criou o serviço.

19989224166xxxxxxx

Accessibility

string

Não

PUBLIC

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

40325405-579C-4D82****

Services

array

A lista de serviços.

Service

Uma instância de serviço.

PageNumber

integer

O número da página atual.

1

PageSize

integer

O número de serviços por página.

100

TotalCount

integer

O número total de serviços.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "40325405-579C-4D82****",
  "Services": [
    {
      "RequestId": "40325405-579C-4D82********",
      "Region": "cn-shanghai",
      "CallerUid": "20123*******",
      "ParentUid": "11234*******",
      "CurrentVersion": 1,
      "Cpu": 1,
      "Gpu": 0,
      "Image": "registry.cn-shanghai.aliyuncs.com/eas/echo_cn-shanghai:v0.0.1-20210129111320",
      "PendingInstance": 0,
      "RunningInstance": 1,
      "TotalInstance": 1,
      "InternetEndpoint": "http://10123*****.cn-shanghai.aliyuncs.com/api/predict/echo",
      "IntranetEndpoint": "http://10123*****.vpc.cn-shanghai.aliyuncs.com/api/predict/echo",
      "LatestVersion": 1,
      "Memory": 1024,
      "Message": "Service start successfully",
      "Namespace": "echo",
      "Reason": "RUNNING",
      "Resource": "eas-r-xxxxxxx",
      "ResourceAlias": "my_resource",
      "ServiceConfig": "{\"metadata\":{\"cpu\":1,\"instance\":1,\"memory\":1024},\"name\":\"echo\",\"processor_entry\":\"libecho.so\",\"processor_path\":\"http://oss-cn-hangzhou-zmf.aliyuncs.com/059247/echo_processor_release.tar.gz\",\"processor_type\":\"cpp\"}",
      "ServiceName": "echo",
      "ServiceGroup": "my_group",
      "Status": "Running",
      "CreateTime": "2021-01-29T11:13:20Z",
      "UpdateTime": "2021-01-29T11:13:20Z",
      "Weight": 100,
      "ServiceId": "eas-m-xxasdat",
      "ServiceUid": "eas-m-xxasdat\n",
      "AccessToken": "MzJiMDI5MDliODc0MTlkYmI0ZDhlYmExYjczYTIyZTE3Zm********",
      "Source": "dsw",
      "ExtraData": "{\"blue_green_services\":[\"test\",\"testxxxx\"]}",
      "Role": "Queue",
      "RoleAttrs": "{\"ApproxMaxLength\":null,\"Length\":null,\"MaxPayloadBytes\":null}",
      "SafetyLock": "dangerous",
      "SecondaryInternetEndpoint": "http://10123*****.cn-shanghai.aliyuncs.com/api/predict/async_path.echo\n",
      "SecondaryIntranetEndpoint": "http://10123*****.vpc.cn-shanghai.aliyuncs.com/api/predict/async_path.echo\n",
      "Labels": [
        {
          "LabelKey": "key1",
          "LabelValue": "value1"
        }
      ],
      "WorkspaceId": "123445",
      "AppType": "LLM",
      "AppConfig": "{\"ModelStorage\":\"oss\"}",
      "AppSpecName": "llama_7b_fp16",
      "AppVersion": "v1",
      "TrafficState": "standalone",
      "QuotaId": "quotaxxxxx",
      "Gateway": "gw-xxxxxx",
      "GPUMemory": 20,
      "GPUCorePercentage": 50,
      "ResourceBurstable": true,
      "CronscalerEnabled": true,
      "AutoscalerEnabled": true,
      "InstanceCountInResource": {
        "Public": 10,
        "Dedicated": 10,
        "Quota": 10
      },
      "WorkloadType": ""
    }
  ],
  "PageNumber": 1,
  "PageSize": 100,
  "TotalCount": 2
}

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.