InsertApplication - Enterprise Distributed Application Service: Central de Documentação do Alibaba Cloud

Cria uma aplicação em um cluster ECS.

Descrição da operação

Nota

Para criar uma aplicação em um cluster Kubernetes, chame a operação InsertK8sApplication.

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.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

edas:CreateApplication

create

*NameSpace

acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}

Nenhuma

Sintaxe da solicitação

POST /pop/v5/changeorder/co_create_app HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Não	O ID do cluster ECS. Especifique este parâmetro para criar a aplicação em um cluster ECS específico. Se você deixar este parâmetro vazio, a aplicação será criada no cluster padrão. Recomendamos que você especifique este parâmetro.	13136119-f384-4f50-b76e-xxxxxxxxxxx
BuildPackId	integer	Não	O número do pacote de compilação do EDAS-Container. Este parâmetro é obrigatório quando você cria uma aplicação High-speed Service Framework (HSF). Você pode obter o número do pacote de compilação de uma das seguintes maneiras: Chame a operação ListBuildPack. Para mais informações, consulte ListBuildPack. Obtenha o número do pacote de compilação na coluna Número do Pacote de Compilação na tabela Versões de container.	59
Description	string	Não	A descrição da aplicação.	create by edas pop api
ApplicationName	string	Sim	O nome da aplicação. O nome pode conter apenas dígitos, letras, hifens (-) e underscores (_). Deve começar com uma letra e pode ter até 36 caracteres.	hello-edas-test-1
ReservedPortStr	string	Não	(Descontinuado) A porta reservada da aplicação.	8090
EcuInfo	string	Não	O `ecu_id` da instância ECS para a qual você deseja escalar horizontalmente a aplicação. O `ecu_id` é o ID exclusivo de uma instância ECS importada para o EDAS. Para especificar múltiplos `ecu_id`s, separe-os com vírgulas (,). Você pode chamar a operação ListScaleOutEcu para consultar o `ecu_id`. Para mais informações, consulte ListScaleOutEcu.	07bd417a-b863-477d-**-**********
Cpu	integer	Não	(Descontinuado) O número de núcleos de CPU para o container da aplicação em um cluster Swarm.	2
Mem	integer	Não	(Descontinuado) O tamanho da memória para o container da aplicação em um cluster Swarm.	2048
LogicalRegionId	string	Não	O ID do namespace de microsserviços. No console do EDAS, escolha Gerenciamento de Recursos > Namespace de Microsserviços no painel de navegação à esquerda para visualizar o ID do namespace de microsserviços. Você também pode chamar a operação ListUserDefineRegion para consultar o ID. Para mais informações, consulte ListUserDefineRegion. Se o cluster especificado não estiver no namespace de microsserviços padrão, você deve especificar este parâmetro. Caso contrário, o erro `application regionId is different with cluster regionId!` será reportado. Se o cluster estiver no namespace de microsserviços padrão, você não precisa especificar este parâmetro. O namespace de microsserviços da aplicação deve ser o mesmo que o namespace de microsserviços do cluster especificado.	cn-beijing:prod
Jdk	string	Não	(Descontinuado) A versão do Java Development Kit (JDK) que a aplicação utiliza.	8
WebContainer	string	Não	(Descontinuado) A versão do Apache Tomcat.	4
PackageType	string	Não	O formato do pacote de implantação da aplicação. Valores válidos: war e jar.	war
ComponentIds	string	Não	O ID do componente da aplicação. Você pode chamar a operação ListComponents para consultar o ID do componente. Para mais informações, consulte ListComponents. Este parâmetro é obrigatório se a aplicação for executada em um container Apache Tomcat (para aplicações Dubbo implantadas em um pacote WAR) ou em um ambiente de execução padrão de aplicação Java (para aplicações Spring Boot ou Spring Cloud implantadas em um pacote JAR). Os seguintes IDs de componentes de aplicação são comumente usados: 4: Apache Tomcat 7.0.91 7: Apache Tomcat 8.5.42 5: OpenJDK 1.8.x 6: OpenJDK 1.7.x Para definir este parâmetro, você deve atualizar o software development kit (SDK) Java ou Python para a versão 2.57.3 ou posterior. Se você não usar um SDK do EDAS, como aliyun-python-sdk-core, aliyun-java-sdk-core ou Alibaba Cloud CLI, você pode definir este parâmetro.	7
Hooks	string	Não	A configuração do script montado. O valor é uma string JSON. Exemplo: `[{"ignoreFail":false,"name":"postprepareInstanceEnvironmentOnScaleOut","script":"ls"},{"ignoreFail":true,"name":"postdeleteInstanceDataOnScaleIn","script":""},{"ignoreFail":true,"name":"prestartInstance","script":""},{"ignoreFail":true,"name":"poststartInstance","script":""},{"ignoreFail":true,"name":"prestopInstance","script":""},{"ignoreFail":true,"name":"poststopInstance","script":""}]`	[{"ignoreFail":false,"name":"postprepareInstanceEnvironmentOnScaleOut","script":"ls"}]
JvmOptions	string	Não	Os parâmetros personalizados.	-Dproperty=value
MinHeapSize	integer	Não	O tamanho inicial da memória heap. Unidade: MB.	500
MaxPermSize	integer	Não	O tamanho da memória de geração permanente. Unidade: MB.	200
MaxHeapSize	integer	Não	O tamanho máximo da memória heap. Unidade: MB.	1000
EnableUrlCheck	boolean	Não	Especifica se a verificação de integridade por URL deve ser ativada. Valores válidos: true: Ativada false: Desativada	true
EnablePortCheck	boolean	Não	Especifica se a verificação de integridade por porta deve ser ativada. Valores válidos: true: Ativada false: Desativada	true
HealthCheckUrl	string	Não	A URL de verificação de integridade da aplicação. Este parâmetro é equivalente ao parâmetro HealthCheckURL.	http://127.0.0.1:8080/_ehc.html
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aek24j4s4b*****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	integer	O código de status.	200
Message	string	A mensagem retornada.	The application name test-hsy-C5039-paas-6 had been created successfully.
RequestId	string	O ID da solicitação.	4264F69C-686C-4107-B493-0599C8xxxxxx
ApplicationInfo	object	O objeto de aplicação retornado após a criação da aplicação.
ChangeOrderId	string	O ID do processo de alteração.	d0cf569e-dce3-4efb-**-08b70021**
AppName	string	O nome da aplicação.	hello-edas-test-1
Owner	string	O proprietário da aplicação. Este é o usuário que criou a aplicação.	249763358688********
Dockerize	boolean	Indica se a aplicação é uma aplicação Docker. Valores válidos: true: A aplicação é uma aplicação Docker. false: A aplicação não é uma aplicação Docker.	false
RegionName	string	O nome da região.	cn-hangzhou
AppId	string	O ID da aplicação. Este ID é o identificador exclusivo de uma aplicação EDAS.	6c733bcd-6efb-47a1-8226-cf722c******
UserId	string	O ID de usuário do proprietário da aplicação.	tdy218@1362469756xxxxxx
Port	integer	A porta padrão da aplicação é 8080. Você pode chamar a operação UpdateContainerConfiguration para alterar a porta. Para mais informações, consulte UpdateContainerConfiguration.	8080

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": 200,
  "Message": "The application name test-hsy-C5039-paas-6 had been created successfully.",
  "RequestId": "4264F69C-686C-4107-B493-0599C8xxxxxx",
  "ApplicationInfo": {
    "ChangeOrderId": "d0cf569e-dce3-4efb-****-08b70021****",
    "AppName": "hello-edas-test-1",
    "Owner": "249763358688********",
    "Dockerize": false,
    "RegionName": "cn-hangzhou",
    "AppId": "6c733bcd-6efb-47a1-8226-cf722c******",
    "UserId": "tdy218@1362469756xxxxxx",
    "Port": 8080
  }
}

Códigos de erro

Consulte Códigos de ErroCódigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de VersãoNotas de Versão para uma lista completa.