CreateEdgeContainerAppVersion - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Cria uma versão para um aplicativo em contêiner. Você pode iterar o aplicativo com base na versã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

esa:CreateEdgeContainerAppVersion

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Sim	O ID do aplicativo, que pode ser obtido chamando a operação ListEdgeContainerApps.	app-88068867578379****
Name	string	Sim	O nome da versão, que deve ter de 6 a 128 caracteres.	verson1
Remarks	string	Não	A descrição da versão.	test app
Containers	array<object>	Sim	O grupo de contêineres a ser implantado para esta versão, que contém informações sobre imagens. Os dados da imagem contêm o endereço da imagem, o comando de inicialização, os parâmetros, as variáveis de ambiente e as regras de sonda. Você pode especificar uma ou mais imagens. O valor do parâmetro é uma string JSON.	[ { "Name": "container1", "Image": "image1", "Spec": "1C2G", "Command": "/bin/sh", "Args": "-c hello", "ProbeType": "tcpSocket", "ProbeContent": "{\"Port\":8080}" }, { "Name": "container2", "Image": "image2", "Spec": "2C4G", "ProbeType": "httpGet", "ProbeContent": "{\"Path\":\"/\",\"Port\":80,\"InitialDelaySeconds\":10}" } ]
	array<object>	Sim	Os detalhes do contêiner.
Name	string	Sim	O nome do contêiner. O nome deve ser único no mesmo grupo de contêineres.	lxg-demo-er
Image	string	Sim	O endereço da imagem.	registry-vpc.cn-shenzhen.aliyuncs.com/lihe**h/eats_servam:3.
IsACRImage	boolean	Sim	Especifica se a imagem é uma imagem do Container Registry.	false
ACRImageInfo	object	Não	As informações sobre a imagem do Container Registry.
IsEnterpriseRegistry	boolean	Não	Especifica se a imagem é uma imagem do Container Registry de nível empresarial.	false
Domain	string	Não	O nome de domínio da imagem do Container Registry.	1500.***.net
InstanceId	string	Não	O ID da instância do Container Registry.	xcdn-9axbo****
RegionId	string	Não	As regiões nas quais a instância do Container Registry reside.	cn-shanghai
RepoId	string	Não	O ID do repositório de imagens.	crr-h1ghghu60ct****
RepoName	string	Não	O nome do repositório de imagens.	test_71
RepoNamespace	string	Não	O namespace ao qual o repositório de imagens pertence.	safeline
Tag	string	Não	A tag da imagem do Container Registry.	3.40.2
TagUrl	string	Não	A URL da tag da imagem do Container Registry.	registry-vpc.cn-shenzhen.aliyuncs.com/**/eas*m:31
Spec	string	Sim	A especificação de computação do contêiner. Valores válidos: 1C2G, 2C4G, 2C8G, 4C8G, 4C16G, 8C16G e 8C32G.	1C2G
Command	string	Não	O comando usado para iniciar o contêiner. Separe os argumentos com espaços.	nginx
Args	string	Não	Os argumentos passados para o comando de inicialização do contêiner. Separe os parâmetros com espaços.	-a
Storage	string	Sim	A capacidade de armazenamento. Valores válidos: 0.5G, 10G, 20G e 30G.	0.5G
EnvVariables	string	Não	As variáveis de ambiente. Separe as variáveis de ambiente com vírgulas (,).	VITE_APP_TITLE=My App
PostStart	string	Não	O comando executado antes de o contêiner ser iniciado. Separe os argumentos com espaços.	sh poststart.sh "echo hello world"
PreStop	string	Não	O comando executado antes de o contêiner ser parado. Separe os argumentos com espaços.	sh prestop.sh "echo hello world"
ProbeType	string	Sim	O tipo de sonda. Valores válidos: exec: o tipo de comando. tcpSocket: o tipo de sonda TCP. httpGet: o tipo de acesso HTTP.	exec
ProbeContent	object	Sim	O conteúdo da sonda de integridade do contêiner.	For details, see the definition of readiness probes in Kubernetes.
InitialDelaySeconds	integer	Não	O atraso para a inicialização da sonda do contêiner.	1
TimeoutSeconds	integer	Não	O período de tempo limite da verificação de integridade do contêiner.	1
PeriodSeconds	integer	Não	O intervalo entre as verificações de integridade do contêiner.	1
SuccessThreshold	integer	Não	O número de verificações de integridade bem-sucedidas consecutivas necessárias para que um contêiner seja considerado íntegro.	1
FailureThreshold	integer	Não	O número de verificações de integridade com falha consecutivas necessárias para que um contêiner seja considerado não íntegro.	3
Command	string	Não	O comando da sonda do tipo exec.	echo ok
Port	integer	Não	A porta de verificação de integridade.	9991
Host	string	Não	O nome de domínio usado para verificações de integridade.	www.rewrite.com
Path	string	Não	O caminho de verificação de integridade.	/
Scheme	string	Não	O protocolo usado pela solicitação de verificação de integridade do contêiner.	http
HttpHeaders	string	Não	Os cabeçalhos de solicitação incluídos na solicitação de verificação de integridade do contêiner.	[{\"Content-Type\":\"application/json\"}]

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
VersionId	string	O ID da versão criada.	ver-87962637161651****
RequestId	string	O ID da solicitação.	04F0F334-1335-436C-A1D7-6C044FE73368

Exemplos

Resposta de sucesso

JSON formato

{
  "VersionId": "ver-87962637161651****",
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.Name	The specified Name is invalid. Please check the Name parameter, which must be between 6 and 128 characters. Kindly make the necessary modifications and call the interface again.	The Name parameter is not valid. Check the Name parameter, which is between 6 and 128 characters. After modification, call the interface again.
400	InvalidParameter.Percentage	The Percentage parameter is invalid. Please check the Percentage parameter, which should be in the range of 1-100. Modify it accordingly and call the interface again.	The Percentage parameter is invalid. Check the Percentage parameter. The parameter range is 1-100. Modify the parameter and call the interface again.
400	InvalidParameter.Image	The specified Image is invalid. Please check the Image parameter and make the necessary modifications and call the interface again.	Illegal Image parameter. Please check the Image parameter, which cannot be assigned to illegal characters such @.
400	InvalidParameter.HttpHeaders	The specified HttpHeaders is invalid. Please check the HttpHeaders parameter. Please make the necessary changes and call the interface again.	The HttpHeaders parameter is invalid. Please check whether the HttpHeaders parameter is filled in. The parameter cannot contain @.
400	InvalidParameter.appid	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	ParameterAlreadyExist	Parameter uniqueness verification failed. Check for duplicate parameter values.	Parameter uniqueness verification failed. Check for duplicate parameter values.
400	NameAlreadyExists	The name already exists.	Name already exists.
500	InternalError	Failed to call the service. Try again later or contact technical support.	Failed to call the service. Try again later or contact technical support.
404	InvalidApp.NotFound	The application does not exist. Check whether the application ID you specified is correct and try again.	The application does not exist. Check whether the application ID you specified is correct and try again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.