Todos os produtos
Search
Central de documentação

Serverless App Engine:CreateApplication

Última atualização: Jul 10, 2026

Cria uma aplicaçã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

sae:CreateApplication

create

*All Resource

*

Nenhuma Nenhuma

Sintaxe da solicitação

POST /pop/v1/sam/app/createApplication HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AppName

string

Sim

O nome da aplicação. O nome pode conter dígitos, letras e hifens (-). O nome deve começar com uma letra e não pode terminar com um hífen (-). O nome pode ter até 36 caracteres.

test

NamespaceId

string

Não

O ID do namespace SAE. Apenas namespaces cujos nomes contenham letras minúsculas e hifens (-) são suportados. O nome deve começar com uma letra. Você pode obter namespaces chamando a operação DescribeNamespaceList.

cn-beijing:test

AppDescription

string

Não

A descrição da aplicação. A descrição pode ter até 1024 caracteres.

This is a test description.

VpcId

string

Não

A VPC que corresponde ao namespace SAE. No SAE, um namespace pode corresponder a apenas uma VPC, e o mapeamento não pode ser modificado. A relação de vinculação é estabelecida quando a primeira aplicação SAE é criada no namespace. Vários namespaces podem corresponder à mesma VPC. Se você deixar este parâmetro vazio, a VPC vinculada ao namespace será usada por padrão.

vpc-bp1aevy8sofi8mh1q****

VSwitchId

string

Não

O vSwitch onde reside o controlador de interface de rede elástica (NIC) da instância da aplicação. O vSwitch deve estar na VPC especificada. O vSwitch também tem uma relação de vinculação com o namespace SAE. Se você deixar este parâmetro vazio, o vSwitch anexado ao namespace será usado por padrão.

vsw-bp12mw1f8k3jgygk9****

PackageType

string

Sim

O tipo do pacote de implantação da aplicação. Valores válidos:

  • Se você usar Java para implantação, FatJar, War e Image são suportados.

  • Se você usar PHP para implantação, os seguintes tipos são suportados:

    • PhpZip

    • IMAGE_PHP_5_4

    • IMAGE_PHP_5_4_ALPINE

    • IMAGE_PHP_5_5

    • IMAGE_PHP_5_5_ALPINE

    • IMAGE_PHP_5_6

    • IMAGE_PHP_5_6_ALPINE

    • IMAGE_PHP_7_0

    • IMAGE_PHP_7_0_ALPINE

    • IMAGE_PHP_7_1

    • IMAGE_PHP_7_1_ALPINE

    • IMAGE_PHP_7_2

    • IMAGE_PHP_7_2_ALPINE

    • IMAGE_PHP_7_3

    • IMAGE_PHP_7_3_ALPINE

  • Se você usar Python para implantação, PythonZip e Image são suportados.

  • Se você usar .NET Core para implantação, DotnetZip e Image são suportados.

    Nota

    Quando DotnetZip é selecionado, Dotnet especifica a versão do runtime do .NET Core. .NET 3.1, .NET 5.0, .NET 6.0, .NET 7.0 e .NET 8.0 são suportados. Os parâmetros Dotnet, Command e CommandArgs são obrigatórios.

FatJar

PackageVersion

string

Não

A versão do pacote de implantação. Este parâmetro é obrigatório quando Package Type está definido como FatJar, War ou PythonZip.

1.0.0

PackageUrl

string

Não

O endereço do pacote de implantação. Este parâmetro é obrigatório quando Package Type está definido como FatJar, War ou PythonZip.

http://myoss.oss-cn-****.aliyuncs.com/my-buc/2019-06-30/****.jar

ImageUrl

string

Não

O endereço da imagem. Este parâmetro é obrigatório quando Package Type está definido como Image.

registry.cn-hangzhou.aliyuncs.com/sae_test/ali_sae_test:0.0.1

Jdk

string

Não

A versão do JDK da qual o pacote de implantação depende. Valores válidos:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

Este parâmetro não é suportado quando Package Type está definido como Image.

Open JDK 8

WebContainer

string

Não

A versão do Tomcat da qual o pacote de implantação WebContainer depende. Valores válidos:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Este parâmetro não é suportado quando Package Type está definido como Image.

apache-tomcat-7.0.91

Cpu

integer

Não

As especificações de CPU necessárias para cada instância, em milicores. Este parâmetro não pode ser definido como 0. Apenas as seguintes especificações definidas são suportadas:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Memory

integer

Não

A memória necessária para cada instância, em MB. Este parâmetro não pode ser definido como 0. A memória tem um mapeamento um para um com a CPU. Apenas as seguintes especificações definidas são suportadas:

  • 1024: corresponde a 500 e 1000 milicores de CPU.

  • 2048: corresponde a 500, 1000 e 2000 milicores de CPU.

  • 4096: corresponde a 1000, 2000 e 4000 milicores de CPU.

  • 8192: corresponde a 2000, 4000 e 8000 milicores de CPU.

  • 12288: corresponde a 12000 milicores de CPU.

  • 16384: corresponde a 4000, 8000 e 16000 milicores de CPU.

  • 24576: corresponde a 12000 milicores de CPU.

  • 32768: corresponde a 16000 milicores de CPU.

  • 65536: corresponde a 8000, 16000 e 32000 milicores de CPU.

  • 131072: corresponde a 32000 milicores de CPU.

1024

Replicas

integer

Sim

O número inicial de instâncias.

1

Command

string

Não

O comando usado para iniciar a imagem. O comando deve ser um objeto executável no contêiner. Exemplo:

command:
      - echo
      - abc
      - >
      - file0

No exemplo anterior, Command="echo", CommandArgs=["abc", ">", "file0"].

Importante Este parâmetro é obrigatório quando PackageType está definido como DotnetZip.

echo

CommandArgs

string

Não

Os argumentos do comando de inicialização da imagem. Estes são os argumentos exigidos pelo comando de inicialização especificado em Command. Formato:

["a","b"]

No exemplo anterior, CommandArgs=["abc", ">", "file0"], onde ["abc", ">", "file0"] deve ser convertido para o tipo String. O formato interno é um array JSON. Se este parâmetro não for necessário, deixe-o vazio.

Importante Este parâmetro é obrigatório quando PackageType está definido como DotnetZip.

["a","b"]

Envs

string

Não

Os parâmetros de variáveis de ambiente do contêiner. Você pode personalizar variáveis de ambiente ou referenciar um ConfigMap. Para referenciar um ConfigMap, crie primeiro uma instância de ConfigMap. Para mais informações, consulte CreateConfigMap. Valores válidos:

  • Configuração personalizada
    • name: o nome da variável de ambiente.

    • value: o valor da variável de ambiente. Isso tem prioridade sobre valueFrom.

  • Referenciar um ConfigMap (valueFrom)
    • name: o nome da variável de ambiente. Você pode referenciar uma única chave ou todas as chaves. Para referenciar todas as chaves, insira sae-sys-configmap-all-<nome do ConfigMap>, como sae-sys-configmap-all-test1.

    • valueFrom: a referência da variável de ambiente. Defina o valor como configMapRef.
      • configMapId: o ID do ConfigMap.

      • key: a chave. Se você referenciar todas as chaves, não defina este campo.

[ { "name": "sae-sys-configmap-all-hello", "valueFrom": { "configMapRef": { "configMapId": 100, "key": "" } } }, { "name": "hello", "valueFrom": { "configMapRef": { "configMapId": 101, "key": "php-fpm" } } }, { "name": "envtmp", "value": "newenv" } ]

CustomHostAlias

string

Não

O mapeamento de host personalizado no contêiner. Valores válidos:

  • hostName: o nome de domínio ou hostname.

  • ip: o endereço IP.

[{"hostName":"samplehost","ip":"127.0.0.1"}]

JarStartOptions

string

Não

As opções para iniciar a aplicação de pacote JAR. O comando de inicialização padrão para a aplicação: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

-Xms4G -Xmx4G

JarStartArgs

string

Não

Os argumentos para iniciar a aplicação de pacote JAR. O comando de inicialização padrão para a aplicação: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

custom-args

Liveness

string

Não

A verificação de integridade do contêiner. Contêineres que falham na verificação de integridade são encerrados e recuperados. Os seguintes métodos são suportados:

  • exec: por exemplo, {"exec":{"command":\["sh","-c","cat/home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

  • httpGet: por exemplo, {"httpGet":{"path":"/","port":18091,"scheme":"HTTP","isContainKeyWord":true,"keyWord":"SAE"},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

  • tcpSocket: por exemplo, {"tcpSocket":{"port":18091},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

Nota

Você pode usar apenas um método para verificações de integridade.

Descrição dos parâmetros:

  • exec.command: o comando de verificação de integridade.

  • httpGet.path: o caminho de acesso.

  • httpGet.scheme: HTTP ou HTTPS.

  • httpGet.isContainKeyWord: true indica que a palavra-chave está incluída. false indica que a palavra-chave não está incluída. Se este campo estiver ausente, o recurso avançado não é usado.

  • httpGet.keyWord: a palavra-chave personalizada. O campo isContainKeyWord deve estar presente quando este campo for usado.

  • tcpSocket.port: a porta para detecção de conexão TCP.

  • initialDelaySeconds: o tempo de detecção de atraso da verificação de integridade. Valor padrão: 10. Unidade: segundos.

  • periodSeconds: o período de verificação de integridade. Valor padrão: 30. Unidade: segundos.

  • timeoutSeconds: o período de tempo limite da verificação de integridade. Valor padrão: 1. Unidade: segundos. Se este parâmetro for definido como 0 ou não for definido, o período de tempo limite padrão é de 1 segundo.

{"exec":{"command":["sh","-c","cat /home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

Readiness

string

Não

A verificação de status de inicialização da aplicação. Contêineres que falham em várias verificações de integridade são encerrados e reiniciados. Contêineres que não passam na verificação de integridade não recebem tráfego SLB. Os métodos exec, httpGet e tcpSocket são suportados. Para exemplos específicos, consulte o parâmetro Liveness.

Nota

Você pode usar apenas um método para verificações de integridade.

{"exec":{"command":["sh","-c","cat /home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

Deploy

boolean

Não

Especifica se a aplicação deve ser implantada imediatamente. Valores válidos:

  • true: valor padrão. A aplicação é implantada imediatamente.

  • false: a aplicação é implantada posteriormente.

true

EdasContainerVersion

string

Não

A versão do ambiente de runtime da aplicação no framework HSF, como o contêiner Ali-Tomcat.

3.5.3

Timezone

string

Não

O fuso horário. Valor padrão: Asia/Shanghai.

Asia/Shanghai

SlsConfigs

string

Não

As configurações para coleta de logs no Simple Log Service.

  • Use recursos SLS criados automaticamente pelo SAE: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

  • Use recursos SLS personalizados: [{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}].

Descrição dos parâmetros:

  • projectName: o nome do Project no Simple Log Service.

  • logDir: o caminho do log.

  • logType: o tipo de log. stdout indica logs de saída padrão do contêiner. Você pode configurar apenas uma entrada para este tipo. Se este parâmetro não for definido, logs de arquivo serão coletados.

  • logstoreName: o nome do Logstore no Simple Log Service.

  • logtailName: o nome do Logtail no Simple Log Service. Se este parâmetro não for especificado, um novo Logtail será criado.

Se a configuração de coleta SLS não mudar durante várias implantações, você não precisa definir este parâmetro (ou seja, o campo SlsConfigs não precisa ser incluído na solicitação). Se você não precisar mais do recurso de coleta SLS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo SlsConfigs como "" na solicitação).

Nota

Projects criados automaticamente com a aplicação são excluídos quando a aplicação é excluída. Portanto, não selecione um project criado automaticamente pelo SAE ao selecionar um project existente.

[{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}]

NasId

string

Não

Recomendamos que você não defina este parâmetro. Defina NasConfigs em vez disso. O ID do sistema de arquivos NAS montado. O sistema de arquivos NAS deve estar na mesma região que o cluster. O sistema de arquivos NAS deve ter cota disponível para criação de destino de montagem, ou seu destino de montagem já deve estar em um vSwitch na VPC. Se este parâmetro for deixado vazio e o campo mountDescs existir, um sistema de arquivos NAS será comprado automaticamente e montado em um vSwitch na VPC.

Se a configuração não mudar durante a implantação, você não precisa definir este parâmetro (ou seja, o campo NASId não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo NASId como "" na solicitação).

KSAK****

MountHost

string

Não

Recomendamos que você não defina este parâmetro. Defina NasConfigs em vez disso. O destino de montagem do sistema de arquivos NAS na VPC da aplicação. Se a configuração não mudar durante a implantação, você não precisa definir este parâmetro (ou seja, o campo MountHost não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo MountHost como "" na solicitação).

example.com

MountDesc

string

Não

Recomendamos que você não defina este parâmetro. Defina NasConfigs em vez disso. A descrição da montagem do NAS. Se a configuração não mudar durante a implantação, você não precisa definir este parâmetro (ou seja, o campo MountDesc não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo MountDesc como "" na solicitação).

[{mountPath: "/tmp", nasPath: "/"}]

PreStop

string

Não

O script executado antes de o contêiner ser parado. Um script é acionado e executado antes de o contêiner ser excluído. Formato: {"exec":{"command":\["cat","/etc/group"]}}

{"exec":{"command":["cat","/etc/group"]}}

PostStart

string

Não

O script executado após o contêiner ser iniciado. Um script é acionado e executado imediatamente após a criação do contêiner. Formato: {"exec":{"command":\["cat","/etc/group"]}}

{"exec":{"command":["cat","/etc/group"]}}

WarStartOptions

string

Não

O comando de inicialização para implantar uma aplicação de pacote WAR. O procedimento de configuração é o mesmo do comando de inicialização de uma implantação de imagem. Para mais informações, consulte Configurar um comando de inicialização.

CATALINA_OPTS=\"$CATALINA_OPTS $Options\" catalina.sh run

ConfigMapMountDesc

string

Não

A descrição da montagem do ConfigMap. Use um ConfigMap criado na página de itens de configuração do namespace para injetar informações de configuração no contêiner. Descrição dos parâmetros:

  • configMapId: o ID da instância do ConfigMap. Você pode obter o ID invocando a operação ListNamespacedConfigMaps.

  • key: a chave.

Nota

Você pode montar todas as chaves passando o parâmetro sae-sys-configmap-all.

  • mountPath: o caminho de montagem.

[{"configMapId":16,"key":"test","mountPath":"/tmp"}]

SecurityGroupId

string

Não

O ID do grupo de segurança.

sg-wz969ngg2e49q5i4****

AutoConfig

boolean

Não

Especifica se o ambiente de rede deve ser configurado automaticamente. Valores válidos:

  • true: O SAE configura automaticamente o ambiente de rede quando a aplicação é criada. Os valores de NamespaceId, VpcId, vSwitchId e SecurityGroupId são ignorados.

  • false: O SAE configura manualmente o ambiente de rede quando a aplicação é criada.

Nota

Se este parâmetro for definido como true, qualquer outro valor de NamespaceId passado será ignorado.

true

TerminationGracePeriodSeconds

integer

Não

O período de tempo limite para desligamento gracioso. Valor padrão: 30. Unidade: segundos. Valores válidos: 1 a 300.

30

PhpArmsConfigLocation

string

Não

O caminho de montagem para monitoramento de aplicações PHP. Certifique-se de que o servidor PHP carregue o arquivo de configuração deste caminho. Você não precisa gerenciar o conteúdo da configuração. O SAE renderiza automaticamente o arquivo de configuração correto.

/usr/local/etc/php/conf.d/arms.ini

PhpConfigLocation

string

Não

O caminho de montagem para a configuração de inicialização da aplicação PHP. Certifique-se de que o servidor PHP use este arquivo de configuração para iniciar.

/usr/local/etc/php/php.ini

PhpConfig

string

Não

O conteúdo do arquivo de configuração do PHP.

k1=v1

TomcatConfig

string

Não

A configuração do Tomcat. Defina este parâmetro como "" ou "{}" para excluir a configuração:

  • port: o número da porta. Valores válidos: 1024 a 65535. Portas menores que 1024 requerem permissões de root. Como o contêiner é configurado com permissões de administrador, especifique uma porta maior que 1024. Valor padrão: 8080.

  • contextPath: o caminho de acesso. Valor padrão: diretório raiz "/".

  • maxThreads: o número máximo de conexões no pool de conexões. Valor padrão: 400.

  • uriEncoding: o formato de codificação do Tomcat. Valores válidos: UTF-8, ISO-8859-1, GBK e GB2312. Valor padrão: ISO-8859-1.

  • useBodyEncodingForUri: especifica se deve usar BodyEncoding for URL. Valor padrão: true.

{"port":8080,"contextPath":"/","maxThreads":400,"uriEncoding":"ISO-8859-1","useBodyEncodingForUri":true}

OssMountDescs

string

Não

A descrição da montagem OSS. Descrição dos parâmetros:

  • bucketName: o nome do bucket.

  • bucketPath: a pasta ou objeto criado no OSS. Se a pasta de montagem do OSS não existir, uma exceção será acionada.

  • mountPath: o caminho do contêiner no SAE. Se o caminho já existir, é uma relação de sobrescrita. Se o caminho não existir, ele será criado.

  • readOnly: especifica se o caminho do contêiner tem permissão somente leitura nos recursos da pasta montada. Valores válidos:
    • true: permissão somente leitura.

    • false: permissão de leitura e gravação.

[{"bucketName": "oss-bucket", "bucketPath": "data/user.data", "mountPath": "/usr/data/user.data", "readOnly": true}]

OssAkId

string

Não

O AccessKey ID para operações de leitura e gravação no OSS.

xxxxxx

OssAkSecret

string

Não

O AccessKey Secret para operações de leitura e gravação no OSS.

xxxxxx

Php

string

Não

A versão do PHP da qual o pacote de implantação depende. Não suportado para imagens.

PHP-FPM 7.0

AcrInstanceId

string

Não

O ID da instância do Container Registry Enterprise. Este parâmetro é obrigatório quando ImageUrl está definido como uma imagem do Container Registry Enterprise Edition.

cri-xxxxxx

AcrAssumeRoleArn

string

Não

O ARN da função RAM necessária para pull de imagens entre contas. Para mais informações, consulte Conceder permissões entre contas Alibaba Cloud usando uma função RAM.

acs:ram::123456789012****:role/adminrole

ImagePullSecrets

string

Não

O ID do secret correspondente.

10

AssociateEip

boolean

Não

Especifica se um EIP deve ser associado. Valores válidos:

  • true: associar um EIP.

  • false: não associar um EIP.

true

ProgrammingLanguage

string

Não

A linguagem de programação da pilha de tecnologia usada para criar a aplicação. Valores válidos:

  • java: Java.

  • php: PHP.

  • python: Python.

  • dotnet: .NET Core.

  • other: múltiplas linguagens, como C++, Go e Node.js.

java

KafkaConfigs

string

Não

O resumo das configurações para coleta de logs no Kafka. Valores válidos:

  • kafkaEndpoint: o endereço de registro de serviço da API do Kafka.

  • kafkaInstanceId: o ID da instância do Kafka.

  • kafkaConfigs: o resumo das configurações para uma ou mais entradas de log. Para mais informações sobre os valores válidos, consulte o parâmetro de solicitação kafkaConfigs neste tópico.

{"kafkaEndpoint":"10.0.X.XXX:XXXX,10.0.X.XXX:XXXX,10.0.X.XXX:XXXX","kafkaInstanceId":"alikafka_pre-cn-7pp2l8kr****","kafkaConfigs":[{"logType":"file_log","logDir":"/tmp/a.log","kafkaTopic":"test2"},{"logType":"stdout","logDir":"","kafkaTopic":"test"}]}

PvtzDiscoverySvc

string

Não

Ativa o registro e descoberta de serviços baseados em K8s Service. Valores válidos:

  • serviceName: o nome do serviço. Formato: nome personalizado-ID do namespace. O sufixo -ID do namespace não pode ser personalizado e deve ser definido com base no namespace da aplicação. Por exemplo, se você selecionar o namespace padrão na região China (Pequim), o sufixo é -cn-beijing-default.

  • namespaceId: o ID do namespace.

  • portProtocols: a porta e o protocolo. Valores válidos de porta: [1,65535]. Valores válidos de protocolo: TCP e UDP.

  • portAndProtocol: a porta e o protocolo. Valores válidos de porta: [1,65535]. Valores válidos de protocolo: TCP e UDP. portProtocols é recomendado. Se portProtocols for definido, apenas portProtocols terá efeito.

  • enable: ativa o registro e descoberta de serviços baseados em K8s Service.

{"serviceName":"bwm-poc-sc-gateway-cn-beijing-front","namespaceId":"cn-beijing:front","portAndProtocol":{"18012":"TCP"},"enable":true,"portProtocols":[{"port":18012,"protocol":"TCP"}]}

MicroRegistration

string

Não

Especifica o registro Nacos. Valores válidos:

  • 0: Nacos integrado ao SAE.

  • 1: Nacos autogerenciado.

  • 2: Nacos da edição comercial MSE.

"0"

MicroRegistrationConfig

string

Não

A configuração do registro.

{\"instanceId\":\"mse-cn-zvp2bh6h70r\",\"namespace\":\"4c0aa74f-57cb-423c-b6af-5d9f2d0e3dbd\"}

NasConfigs

string

Não

A configuração de montagem do NAS. Valores válidos:

  • mountPath: o caminho de montagem do contêiner.

  • readOnly: defina como false para conceder permissão de leitura e gravação.

  • nasId: o ID do NAS.

  • mountDomain: o endereço de destino de montagem do contêiner. Para mais informações, consulte DescribeMountTargets.

  • nasPath: o diretório relativo de arquivos do NAS.

[{"mountPath":"/test1","readOnly":false,"nasId":"nasId1","mountDomain":"nasId1.cn-shenzhen.nas.aliyuncs.com","nasPath":"/test1"},{"nasId":"nasId2","mountDomain":"nasId2.cn-shenzhen.nas.aliyuncs.com","readOnly":false,"nasPath":"/test2","mountPath":"/test2"}]

Python

string

Não

O ambiente Python. PYTHON 3.9.15 é suportado.

PYTHON 3.9.15

PythonModules

string

Não

As dependências de módulos de instalação personalizada. Por padrão, as dependências definidas no arquivo requirements.txt na pasta raiz são instaladas. Se o arquivo não estiver configurado ou se você precisar de pacotes personalizados, especifique as dependências a serem instaladas.

Flask==2.0

Dotnet

string

Não

A versão do framework .NET:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 3.1

EnableEbpf

string

Não

Especifica se o monitoramento de aplicações para aplicações não Java baseado na tecnologia eBPF deve ser ativado. Valores válidos:

  • true: ativado.

  • false: desativado. Este é o valor padrão.

false

SaeVersion

string

Não

A versão do SAE. Valores válidos:

  • v1

  • v2

v1

AppSource

string

Não

Defina este parâmetro como micro_service para criar uma aplicação de microsserviço.

micro_service

BaseAppId

string

Não

O ID da aplicação base.

ee99cce6-1c8e-4bfa-96c3-3e2fa9de8a41

ServiceTags

string

Não

As tags de lançamento canário configuradas para a aplicação.

{\"alicloud.service.tag\":\"g1\"}

EnableNewArms

boolean

Não

Especifica se o novo recurso ARMS deve ser ativado:

  • true: Ativado.

  • false: Desativado.

false

EnableCpuBurst

boolean

Não

Especifica se o recurso CPU Burst deve ser ativado:

  • true: Ativado.

  • false: Desativado.

true

OidcRoleName

string

Não

Especifica a função RAM para autenticação de identidade.

Nota

Crie um provedor de identidade OIDC e uma função de provedor de identidade na mesma região antecipadamente. Para mais informações, consulte CreateOIDCProvider e CreateSAMLProvider.

sae-test

SidecarContainersConfig

array

Não

A configuração do contêiner sidecar.

SidecarContainerConfig

Não

A configuração do contêiner sidecar.

SecretMountDesc

string

Não

A descrição da montagem do Secret. Use um secret criado na página de secrets do namespace para injetar informações confidenciais no contêiner. Descrição dos parâmetros:

  • secretId: o ID da instância do secret. Você pode obter o ID chamando a operação ListSecrets.

  • key: a chave.

Nota

Você pode montar todas as chaves passando o parâmetro sae-sys-secret-all.

  • mountPath: o caminho de montagem.

[{“secretId":10,”key":"test","mountPath":"/tmp"}]

EnableSidecarResourceIsolated

boolean

Não

Especifica se o isolamento de recursos do sidecar deve ser ativado:

  • true: Isolado.

  • false: Não isolado.

true

CustomImageNetworkType

string

Não

O tipo de imagem personalizada. Defina este parâmetro como uma string vazia se a imagem não for uma imagem personalizada:

  • internet: imagem pública

  • intranet: imagem privada

internet

ResourceType

string

Não

O tipo de recurso. Valores válidos: NULL (padrão), default e haiguang (servidor Hygon).

NULL

NewSaeVersion

string

Não

A versão da aplicação:

  • lite: Edição Lite

  • std: Edição Standard

  • pro: Edição Professional

pro

MicroserviceEngineConfig

string

Não

Configura o recurso de governança de microsserviços.

  • Especifica se a governança de microsserviços deve ser ativada (enable):

    • true: Ativado.

    • false: Desativado.

  • Configura online/offline sem perdas (mseLosslessRule):

    • delayTime: o tempo de atraso.

    • enable: especifica se o recurso online sem perdas deve ser ativado. true indica ativado. false indica desativado.

    • notice: especifica se o recurso de notificação deve ser ativado. true indica ativado. false indica desativado.

    • warmupTime: a duração do aquecimento para aumento gradual de tráfego, em segundos.

{"enable": true,"mseLosslessRule": {"delayTime": 0,"enable": false,"notice": false,"warmupTime": 120}}

DiskSize

integer

Não

O tamanho do armazenamento em disco, em GB.

50

InitContainersConfig

array

Não

A configuração do contêiner de inicialização.

InitContainerConfig

Não

A configuração do contêiner de inicialização.

GpuConfig

string

Não

StartupProbe

string

Não

Ativa a sonda de inicialização da aplicação.

  • Verificação bem-sucedida: indica que a aplicação foi iniciada com sucesso. Se você configurou verificações de Liveness e Readiness, elas são realizadas após a aplicação ser iniciada com sucesso.

  • Verificação falhou: indica que a aplicação falhou ao iniciar. Uma exceção é relatada e a aplicação é reiniciada automaticamente.

Nota
  • Os métodos exec, httpGet e tcpSocket são suportados. Para exemplos específicos, consulte o parâmetro Liveness.

  • Você pode usar apenas um método para verificações de integridade.

{"exec":{"command":["sh","-c","cat /home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

IsStateful

boolean

Não

Especifica se a aplicação é stateful.

EnablePrometheus

boolean

Não

Especifica se a coleta de métricas personalizadas do Prometheus deve ser ativada.

false

HeadlessPvtzDiscoverySvc

string

Não

O registro e descoberta de serviços baseados em K8s Headless Service.

  • serviceName: o nome do serviço.

  • namespaceId: o ID do namespace.

{\"serviceName\":\"leaf-test-headless\",\"namespaceId\":\"cn-zhangjiakou:prod\"}

Html

string

Não

A versão do Nginx.

  • nginx 1.20

  • nginx 1.22

  • nginx 1.24

  • nginx 1.26

  • nginx 1.28

nginx 1.28

EmptyDirDesc

string

Não

A configuração de armazenamento efêmero compartilhado.

[{\"name\":\"workdir\",\"mountPath\":\"/usr/local/tomcat/webapps\"}]

AgentVersion

string

Não

Especifica se a configuração da versão do agente do namespace deve ser reutilizada.

4.4.2

EnableNamespaceAgentVersion

boolean

Não

A versão do AliyunAgent.

true

EnableNamespaceSlsConfig

boolean

Não

Especifica se a configuração de logs SLS do namespace deve ser reutilizada.

true

SlsLogEnvTags

string

Não

Tags de log sls.

LokiConfigs

string

Não

Labels

object

Não

string

Não

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

As informações sobre a aplicação criada.

RequestId

string

O ID da solicitação.

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

As informações adicionais. Valores válidos:

  • Se a solicitação for bem-sucedida, success será retornado.

  • Se a solicitação falhar, um código de erro específico será retornado.

success

TraceId

string

O ID de rastreamento, usado para consultar os detalhes de uma solicitação.

0a98a02315955564772843261e****

Data

object

O resultado retornado.

ChangeOrderId

string

O ID da ordem de alteração retornado, usado para consultar o status de execução da tarefa.

01db03d3-3ee9-48b3-b3d0-dfce2d88****

AppId

string

O ID da aplicação criada.

017f39b8-dfa4-4e16-a84b-1dcee4b1****

ErrorCode

string

O código de erro. Valores válidos:

  • Se a solicitação for bem-sucedida, o campo ErrorCode não será retornado.

  • Se a solicitação falhar, o campo ErrorCode será retornado. Para mais informações, consulte a seção Códigos de erro neste tópico.

Code

string

O status da API ou código de erro POP. Valores válidos:

  • 2xx: sucesso.

  • 3xx: redirecionamento.

  • 4xx: erro de solicitação.

  • 5xx: erro de servidor.

200

Success

boolean

Indica se a aplicação foi criada. Valores válidos:

  • true: A aplicação foi criada.

  • false: Falha ao criar a aplicação.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "ChangeOrderId": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
    "AppId": "017f39b8-dfa4-4e16-a84b-1dcee4b1****"
  },
  "ErrorCode": "空",
  "Code": "200",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Application.MissingJdk Your application must at least contain a JDK component.
400 InvalidPackageType.NotFound The package type must be War, FatJar, or Image.
400 InvalidParameter.NotEmpty You must specify the parameter %s.
400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
400 JarApplication.MissingJdk A FatJar application must contain JDK.
400 NoAvailableCluster.NotFound No clusters are available for the current region.
400 NoComputeResourceQuota.Exceed Your compute resource is insufficient. Please contact us to raise the quota.
400 PandoraApplication.MissingJdk The Pandora application is missing a JDK component.
400 PandoraApplication.OnlyJdk A Pandora application only requires JDK component.
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s
400 InvalidComponent.NotFound The current component (such as JDK, Tomcat, or EDASWebContainer) does not exist.
400 InvalidHostnameIp.Invalid The hostname and/or IP is invalid: Hostname [%s], IP [%s].
400 InvalidInstanceSpecification.Unsupported The instance specification is not supported: CPU [%s], memory [%s].
400 InvalidServerlessRegion.Unsupported The current region is not supported: %s
400 WarApplication.MissingJdkWebcontainer A War application must contain JDK and Tomcat.
400 InvalidNamespace.WithUppercase This namespace does not support creating SAE apps because it contains uppercase letters.
400 LogService.ConfigQuotaExceed The maximum number of Log Service configs is exceeded.
400 LogService.InternalError An exception occurred while calling Log Service. Please submit a ticket to solve the problem.
400 LogService.LogDirInvalid The log collection path is invalid.
400 LogService.NotAvailable Log Service is unavailable. Please activate Log Service first.
400 LogService.ProjectNumQuotaExceed The maximum number of Log Service projects is exceeded.
400 user.indebt The user has an outstanding payment.
400 NoComputeResourceQuota.App.Exceed You can create %s instances for each application. Please submit a ticket to raise the quota.
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota.
400 System.Upgrading The system is being upgraded. Please try again later.
400 VolumnPath.Conflict Conflict between log collection directory and persistent storage directory.
400 MountConflict.ConfigMap Conflict detected for ConfigMap path %s.
400 NotFound.ConfigMap The ConfigMap object (ID: %s) does not exist.
400 NotFound.ConfigMapKey The key %s of ConfigMap object (ID: %s) does not exist.
400 Sls.Config.Mixed.Multi.Project The specified Config contains multiple projects.
400 Sls.Config.User.Defined.Missing.Logstore.Info The specified Config is invalid. Both Project and Logstore must be specified.
400 Sls.Config.User.Defined.Missing.Project.Info The specified Config is invalid. Both Project and Logstore must be specified.
400 Sls.Logstore.Name.Invalid The specified name of Logstore is invalid. The Logstore name must not contain the prefix "sae-".
400 Sls.Logstore.User.Defined.Not.Exist The user defined Logstore does not exist.
400 Sls.Project.Name.Invalid The specified project name is invalid. The project name must not contain the prefix "sae-".
400 Sls.Project.User.Defined.Not.Exist The user defined project does not exist.
400 InvalidImageUrl.AcrInstanceId.Domain.NotMatch The specified domain of ImageUrl does not match AcrInstanceId domains.
400 PhpApplication.MissingPhpRuntime A PHP application must contain PHP Runtime.
400 InvalidParameter.FileName The application deployment package name is invalid. This name can contain only alphanumeric characters, hyphens (-), and underscores (_). For deploying java package, you can upload JAR files only if the selected deployment version supports JAR file. Otherwise, upload WAR files only. For deploying php package, you can upload ZIP files only if the selected deployment version supports ZIP file.
400 Sls.Logtail.Name.Invalid The specified name of Logtail is invalid. The Logtail name must not contain the prefix sae-.
400 vswitch.not.exist The specified vSwitch does not exist.
400 InvalidImageUrl.MissingAcrInstanceId The specified domain of ImageUrl is from ACREE, but you are not specified AcrInstanceId.
400 EnvFromSecretIdConflict.AlreadyExist The specified SecretId [%s] already exist in the specified Envs.
400 MountConflict.Secret Conflict detected for Secret path %s.
404 Associate.Eip.Not.Enough No sufficient EIPs are available.
404 InvalidNamespaceId.NotFound The specified NamespaceId does not exist.
404 InvalidVpcId.NotFound The specified VpcId does not exist.
404 InvalidAcrInstanceId.NotFound The specified AcrInstanceId does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.