Todos os produtos
Search

Este produto

    Platform For AI:CreateService

    Central de documentação

    Platform For AI:CreateService

    Última atualização: Oct 27, 2026

    Cria um serviço PAI-EAS.

    Descrição da operação

    Certifique-se de compreender totalmente os métodos de cobrança e os preços do 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:CreateService

    create

    *All resources.

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    POST /api/v2/services HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    body

    string

    Não

    O corpo da solicitação. Para as configurações de parâmetros e a descrição de métricas dos principais parâmetros de solicitação, consulte a Tabela 1. Parâmetros do corpo da solicitação e a Tabela 2. Parâmetros de metadados abaixo. Para mais detalhes sobre as configurações de parâmetros, consulte Todas as descrições de métricas relacionadas para modelos de serviço.

    Image deployment service: {   "name": "foo",   "metadata": {     "instance": 2,     "memory": 7000,     "cpu": 4     },   "containers": [     {       "image": "****",       "script": "**** --listen=0.0.0.0 --server_port=8000 --headless",       "port": 8000     }   ],   "storage": [     {       "oss": {         "path": "oss://examplebuket/data111/",         "readOnly": false       },       "properties": {         "resource_type": "model"       },       "mount_path": "/data"     }   ] } image deploymentAI-Web application: {   "name": "foo",   "metadata": {     "instance": 1,     "memory": 7000,     "cpu": 4,     "enable_webservice": true   },   "containers": [     {       "image": "****",       "script": "**** --listen=0.0.0.0 --server_port=8000 --headless",       "port": 8000     }   ],   "storage": [     {       "oss": {         "path": "oss://examplebucket/data111/",         "readOnly": false       },       "properties": {       "resource_type": "model"       },       "mount_path": "/data"     }   ] } model+processor deployment service: {   "metadata": {     "instance": 1,     "memory": 7000,     "cpu": 4   },   "name": "foo",   "model_config": {},   "processor_type": "python",   "processor_path": "oss://****",   "processor_entry": "a.py",   "model_path": "oss://****" }
    Develop

    string

    Não

    Especifica se deve entrar no modo de desenvolvimento.

    Valores válidos:

    • true :

      Entra no modo de desenvolvimento.

    • false :

      Não entra no modo de desenvolvimento.

    true
    Labels

    object

    Não

    Os rótulos personalizados.

    string

    Não

    O rótulo.

    {"key":"value"}
    WorkspaceId

    string

    Não

    O ID do espaço de trabalho.

    123456

    Tabela 1. Parâmetros do corpo da solicitação

    NomeTipoObrigatórioDescrição
    nameStringSimO nome do serviço. Deve ser globalmente exclusivo na mesma região.
    tokenStringNãoA string de token usada para autenticação de acesso. Se você não especificar este parâmetro, um token será gerado automaticamente com base em generate_token.
    model_pathStringNãoOs arquivos relacionados ao modelo. Os formatos HTTP e OSS são suportados. O endereço HTTP deve ser publicamente acessível. Se um endereço OSS for usado, a entrada pode ser um diretório ou um arquivo. Se o arquivo for um pacote compactado como .tar.gz, .tar.bz2 ou .zip, ele será descompactado automaticamente.
    role_arnstringNãoO ARN da função usado para autorização do OSS quando model_path ou processor_path é um endereço OSS. Para mais informações sobre como obter o ARN da função, consulte ARN da função.
    oss_endpointStringNãoO endpoint do bucket do OSS quando model_path ou processor_path é um endereço OSS.
    model_entryStringNãoO arquivo de entrada do modelo. Se você não especificar este parâmetro, o nome do arquivo em model_path será usado. Pode conter qualquer arquivo. O caminho do arquivo principal é passado para a função Load() no processador.
    processor_pathStringSimO pacote de arquivos relacionado ao processador. Arquivos locais e URLs HTTP são suportados. Se o arquivo for um pacote compactado como .tar.gz, .tar.bz2 ou .zip, ele será descompactado automaticamente.
    processor_entryStringNãoObrigatório para C, C++ e Python. O arquivo principal do processador, que contém as implementações das funções Load() e Process() necessárias para a previsão.
    processor_mainclassStringNãoObrigatório para Java. O arquivo principal do processador, que é a classe principal no pacote JAR.
    processor_typeStringSimA linguagem de programação usada para implementar o processador. C, C++, Java e Python são suportados.
    metadataDictNãoOs metadados do serviço. Para mais informações, consulte a Tabela 2 abaixo.
    cloudDictNãoUsado apenas quando você implanta o serviço especificando um tipo de instância. O formato do parâmetro é "cloud":{"computing":{"instance_type": "ecs.gxxxxxx.large"}}.
    containersListNãoImplantação de imagem personalizada. Se a implantação do processador não atender aos seus requisitos, você pode usar a implantação de imagem personalizada. Para mais informações, consulte Implantação de serviço: Imagens personalizadas.
    Nota

    model_path e processor_path especificam as fontes de dados para os dados do modelo de entrada e os dados do processador. Fontes de dados HTTP e OSS são suportadas. Arquivos e diretórios locais são suportados quando você usa o comando de teste para depuração local.

    • Se você usar um endereço HTTP, deverá empacotar os arquivos relevantes em um pacote compactado como .tar.gz, .tar.bz2 ou .zip. Você pode fazer upload do pacote para o OSS e gerar um endereço HTTP.

    • Se você usar um endereço OSS, a entrada pode ser um diretório ou um arquivo.

    Tabela 2. Parâmetros de metadados

    NomeTipoObrigatórioDescriçãoExemplo
    instanceIntNãoO número de workers iniciados para o serviço.1
    cpuIntNãoO número de CPUs necessárias para cada worker.1
    gpuIntNãoO número de GPUs necessárias para cada worker.0
    memoryIntNãoO tamanho de memória necessário para cada worker. Unidade: MB.1000
    resourceStringNãoO grupo de recursos ao qual o serviço pertence.eas-r-aaabbbccc
    rpc.worker_threadsIntNãoO número de threads usadas para processar solicitações simultaneamente em cada instância.5
    rpc.max_queue_sizeIntNãoO comprimento máximo da fila durante o processamento da solicitação. Quando a fila está cheia, novas solicitações são descartadas com um código de status 450.64
    rpc.keepaliveIntNãoO período de tempo limite para solicitações. Unidade: milissegundos.5000
    rpc.rate_limitIntNãoO valor de QPS para limitação de solicitações por instância. Solicitações que excedem esse valor de QPS por instância são descartadas com um código de status 429.0
    releaseBoolNãoSe este parâmetro for definido como true, um serviço de versão canário será criado.false

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    O resultado retornado.

    RequestId

    string

    O ID da solicitação.

    40325405-579C-4D82****
    ServiceId

    string

    O ID do serviço recém-criado.

    eas-m-aaxxxddf
    ServiceName

    string

    O nome do serviço recém-criado.

    yourname
    Status

    string

    O status atual do novo serviço.

    Creating
    Region

    string

    O ID da região do serviço recém-criado.

    cn-shanghai
    InternetEndpoint

    string

    O endpoint público do serviço recém-criado.

    http://pai-eas.vpc.cn-shanghai.****
    IntranetEndpoint

    string

    O endpoint interno do serviço recém-criado.

    http://pai-eas.cn-shanghai.****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "40325405-579C-4D82****",
  "ServiceId": "eas-m-aaxxxddf",
  "ServiceName": "yourname",
  "Status": "Creating",
  "Region": "cn-shanghai",
  "InternetEndpoint": "http://pai-eas.vpc.cn-shanghai.****",
  "IntranetEndpoint": "http://pai-eas.cn-shanghai.****"
}

    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.