RollbackApplication - Serverless App Engine: Central de Documentação do Alibaba Cloud

Reverte 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:RollbackApplication

update

*All Resource

*

Nenhuma

Sintaxe da solicitação

PUT /pop/v1/sam/app/rollbackApplication HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Sim	O ID da aplicação.	017f39b8-dfa4-4e16-a84b-1dcee4b1****
VersionId	string	Sim	O ID da versão da aplicação. Execute a operação ListAppVersions para obter o ID da versão.	0026ff7f-2b57-4127-bdd0-9bf202bb9****
BatchWaitTime	integer	Não	O tempo de espera entre os lotes. Unidade: segundos.	10
MinReadyInstances	integer	Não	O número mínimo de instâncias disponíveis. Observe as seguintes regras: Se você definir o valor como 0, ocorrerão interrupções nos negócios quando a aplicação for atualizada. Se você definir o valor como -1, o número mínimo de instâncias disponíveis será definido automaticamente para um valor recomendado pelo sistema. O valor é o número inteiro mais próximo para o qual o resultado calculado da seguinte fórmula é arredondado para cima: Número atual de instâncias × 25%. Por exemplo, se cinco instâncias estiverem disponíveis, o número mínimo de instâncias disponíveis será calculado usando a seguinte fórmula: 5 × 25% = 1,25. Nesse caso, o número mínimo de instâncias disponíveis é 2. Nota Certifique-se de que pelo menos uma instância esteja disponível durante a implantação e o rollback da aplicação para evitar interrupções nos negócios.	1
MinReadyInstanceRatio	integer	Não	A porcentagem do número mínimo de instâncias disponíveis. Observe as seguintes regras: Se você definir o valor como -1, o número mínimo de instâncias disponíveis não será determinado com base neste parâmetro. Valor padrão: -1. Se você definir o valor como um número de 0 a 100, o número mínimo de instâncias disponíveis será calculado usando a seguinte fórmula: Número atual de instâncias × (Valor de MinReadyInstanceRatio × 100%). O valor é o número inteiro mais próximo arredondado para cima a partir do resultado calculado. Por exemplo, se a porcentagem for definida como 50% e cinco instâncias estiverem disponíveis, o número mínimo de instâncias disponíveis será 3. Nota Quando MinReadyInstance e MinReadyInstanceRatio são especificados e MinReadyInstanceRatio é definido como um número de 0 a 100, o valor de MinReadyInstanceRatio tem precedência. Por exemplo, se MinReadyInstances for definido como 5 e MinReadyInstanceRatio for definido como 50, o número mínimo de instâncias disponíveis será definido como o número inteiro mais próximo arredondado para cima a partir do resultado calculado da seguinte fórmula: Número atual de instâncias × 50%.	-1
UpdateStrategy	string	Não	A política de implantação. Se o número mínimo de instâncias disponíveis for 1, o valor do parâmetro UpdateStrategy será uma string vazia (""). Se o número mínimo de instâncias disponíveis for maior que 1, especifique este parâmetro de acordo com seus requisitos. Exemplos: Execute uma liberação canário para uma instância e libere as instâncias restantes em dois lotes automaticamente com um intervalo de um minuto entre a implantação de cada instância: `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}` Execute uma liberação canário para uma instância e libere as instâncias restantes em dois lotes manualmente: `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}` Libere as instâncias em dois lotes automaticamente sem intervalo entre a implantação de cada instância: `{"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}` A tabela a seguir descreve os parâmetros usados nas instruções anteriores. type: o tipo da política de liberação. Valores válidos: GrayBatchUpdate e BatchUpdate. batchUpdate: a política de liberação em fases. batch: o número de lotes de liberação. releaseType: o método de processamento para os lotes. Valores válidos: auto e manual. batchWaitTime: o intervalo entre os lotes de liberação. Unidade: segundos. grayUpdate: o número de lotes de liberação na liberação em fases após uma liberação canário. Este parâmetro é retornado apenas se o parâmetro type estiver definido como GrayBatchUpdate.	{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}
AutoEnableApplicationScalingRule	string	Não	Especifica se uma política de dimensionamento automático deve ser ativada automaticamente para a aplicação. Observe as seguintes regras: true: ativa o dimensionamento automático false: desativa o dimensionamento automático	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	A mensagem retornada para a operação.	success
TraceId	string	O ID de rastreamento usado para consultar os detalhes da solicitação.	0a98a02315955564772843261e****
Data	object	A resposta.
ChangeOrderId	string	O ID do processo de alteração.	01db03d3-3ee9-48b3-b3d0-dfce2d88****
IsNeedApproval	boolean	Especifica se a aprovação é necessária quando um usuário RAM realiza a liberação. Observe as seguintes regras: true false	true
ErrorCode	string	O código de erro retornado se a solicitação falhar. Observe as seguintes regras: O parâmetro ErrorCode não é retornado se a solicitação for bem-sucedida. Se a chamada falhar, o parâmetro ErrorCode será retornado. Para obter mais informações, consulte a seção "Códigos de erro" deste tópico.
Code	string	O código de status HTTP. Observe as seguintes regras: 2xx: A chamada foi bem-sucedida. 3xx: A chamada foi redirecionada. 4xx: A chamada falhou. 5xx: Ocorreu um erro de servidor.	200
Success	boolean	Indica se a aplicação foi revertida com sucesso. Observe as seguintes regras: true false	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "ChangeOrderId": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
    "IsNeedApproval": true
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidApplication.NotFound	The current application does not exist.
400	InvalidParameter.NotEmpty	You must specify the parameter %s.
400	InvalidParameter.Obviously	The specified parameter is invalid {%s}.
400	InvalidParameter.WithMessage	The parameter is invalid {%s}: %s
400	NoComputeResourceQuota.Exceed	Your compute resource is insufficient. Please contact us to raise the quota.
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.	You can create %s instances for each application. please join the DingTalk group 32874633 for technical support.
400	NoComputeResourceQuota.User.Exceed	Your account is limited to create %s instances. Please submit a ticket to raise the quota.	Your account is limited to create %s instances. please join the DingTalk group 32874633 for technical support.
400	System.Upgrading	The system is being upgraded. Please try again later.
400	Application.ChangerOrderRunning	An application change process is in progress. Please try again later.	An application change process is in progress. Please try again later.
400	Application.InvalidStatus	The application status is abnormal. Please try again later.	The application status is abnormal. Please try again later.
400	Application.NotDeployYet	The application has not been deployed. Please deploy it and try again.	The application has not been deployed. Please deploy it and try again.
400	rollback.error	Failed to roll back.	Rollback error
400	Application.MissingJdk	Your application must at least contain a JDK component.
400	JarApplication.MissingJdk	A FatJar application must contain JDK.
400	PandoraApplication.MissingJdk	The Pandora application is missing a JDK component.
400	WarApplication.MissingJdkWebcontainer	A War application must contain JDK and Tomcat.
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	InvalidPackageType.NotFound	The package type must be War, FatJar, or Image.
400	LogService.ConfigQuotaExceed	The maximum number of Log Service configs is exceeded.	The maximum number of Log Service configs is exceeded, please join the DingTalk group 32874633 for technical support.
400	LogService.InternalError	An exception occurred while calling Log Service. Please submit a ticket to solve the problem.	An exception occurred while calling log service. please join the DingTalk group 32874633 for technical support.
400	LogService.LogDirInvalid	The log collection path is invalid.	The log collection path is invalid.
400	LogService.NotAvailable	Log Service is unavailable. Please activate Log Service first.	The log service is not available. Please open the log service first.
400	LogService.ProjectNumQuotaExceed	The maximum number of Log Service projects is exceeded.	The maximum number of Log Service projects is exceeded, please join the DingTalk group 32874633 for technical support.
400	VolumnPath.Conflict	Conflict between log collection directory and persistent storage directory.	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	MinReadyInstances.Not.Smaller.Replicas	The minimum number of available instances must be less than the number of application instances.	The minimum number of available instances must be less than the number of application instances.
400	MinReadyInstanceRatio.Invalid	The ratio of minimum available instances must be between 0 and 100.
400	Package.Version.Too.Long	The maximum length of package version is exceeded.	This package version is too long.
400	App.Package.Version.Exists	The package version of application already exists.	The package version of application already exists.
400	Slb.Occupied	The SLB instance is occupied.	This SLB is occupied.
400	Slb.Tag.Not.Qualified	The current SLB instance cannot be reused because it may have been occupied by %s.	The current SLB instance cannot be reused because it may have been occupied by %s.
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	vswitch.not.exist	The specified vSwitch does not exist.	The specified vSwitch does not exist. Please change the vSwitch.
404	InvalidNamespaceId.NotFound	The specified NamespaceId 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.