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

Reinicia 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:RestartApplication

none

*All Resource

*

Nenhuma

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Sim	O ID da aplicação.	0099b7be-5f5b-4512-a7fc-56049ef1****
MinReadyInstances	integer	Não	O número mínimo de instâncias disponíveis. Valores especiais: 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 a reversão 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
AutoEnableApplicationScalingRule	boolean	Não	Especifica se uma política de dimensionamento automático deve ser ativada automaticamente para a aplicação. Valores válidos: true: ativado. false: desativado	false

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	As informações adicionais que são retornadas. Observe as seguintes regras: success: Se a chamada for bem-sucedida, success será retornado. Um código de erro: Se a chamada falhar, um código de erro será retornado.	success
TraceId	string	O ID de rastreamento que é usado para consultar os detalhes da solicitação.	0a98a02315955564772843261e****
Data	object	A resposta.
ChangeOrderId	string	O ID do processo de alteração.	4a815998-b468-4bea-b7d8-59f52a44****
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 instância foi reiniciada 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": "4a815998-b468-4bea-b7d8-59f52a44****"
  },
  "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.
404	Associate.Eip.Not.Enough	No sufficient EIPs are available.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.