Todos os produtos
Search
Central de documentação

Serverless App Engine:RestartApplication

Última atualização: Oct 21, 2026

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

*Todos os recursos.

*

Nenhuma 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 prontas. Valores válidos:

  • Se você definir este parâmetro como 0, os serviços serão interrompidos durante a atualização da aplicação.

  • Se você definir este parâmetro como -1, o sistema usará o valor recomendado, que é 25% do número atual de instâncias. Por exemplo, se você tiver 5 instâncias, 5 × 25% = 1,25. O valor é arredondado para cima para 2.

Nota

Para cada implantação em rolagem, defina o número mínimo de instâncias prontas como 1 ou mais para garantir a continuidade do serviço.

1

MinReadyInstanceRatio

integer

Não

A porcentagem do número mínimo de instâncias prontas. Valores válidos:

  • -1: o valor inicial, que indica que a porcentagem não é usada.

  • 0 a 100: a porcentagem, que é arredondada para cima. Por exemplo, se você definir este parâmetro como 50 e tiver 5 instâncias, o número mínimo de instâncias prontas será 3.

Nota

Se MinReadyInstances e MinReadyInstanceRatio forem especificados e o valor de MinReadyInstanceRatio não for -1, o parâmetro MinReadyInstanceRatio terá precedência. Por exemplo, se MinReadyInstances estiver definido como 5 e MinReadyInstanceRatio estiver definido como 50, o sistema usará 50 para calcular o número mínimo de instâncias prontas.

-1

AutoEnableApplicationScalingRule

boolean

Não

Especifica se a política de dimensionamento elástico da aplicação é ativada automaticamente. Valores válidos:

  • true: ativa a política.

  • false: desativa a política.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados da resposta.

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, que é usado para consultar os detalhes da invocação.

0a98a02315955564772843261e****

Data

object

O resultado retornado.

ChangeOrderId

string

O ID da ordem de alteração.

4a815998-b468-4bea-b7d8-59f52a44****

ErrorCode

string

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

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

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

InvalidApplication.NotFound

Code

string

O código de 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 instância foi reiniciada com sucesso. Valores válidos:

  • true: A instância foi reiniciada com sucesso.

  • false: A instância não foi reiniciada com sucesso.

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": "InvalidApplication.NotFound",
  "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. A aplicação atual não pode ser encontrada.
400 InvalidParameter.NotEmpty You must specify the parameter %s. Parâmetro inválido: %s não pode estar vazio.
400 InvalidParameter.Obviously The specified parameter is invalid {%s}. Parâmetro inválido {%s}.
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s Parâmetro inválido {%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. O usuário atual tem um pagamento em atraso.
400 NoComputeResourceQuota.App.Exceed You can create %s instances for each application. Please submit a ticket to raise the quota. Cada aplicação pode ter no máximo %s instâncias. Entre no grupo 32874633 do DingTalk para consultar um especialista técnico do produto.
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota. Sua conta tem uma cota de %s instâncias. Entre no grupo 32874633 do DingTalk para consultar um especialista técnico do produto.
400 System.Upgrading The system is being upgraded. Please try again later. O sistema está sendo atualizado. Tente novamente mais tarde.
400 Application.ChangerOrderRunning An application change process is in progress. Please try again later. Um processo de alteração está sendo executado para o aplicativo. Tente novamente mais tarde.
400 Application.InvalidStatus The application status is abnormal. Please try again later. O aplicativo está em um estado anormal. Tente novamente mais tarde.
400 Application.NotDeployYet The application has not been deployed. Please deploy it and try again. O aplicativo não foi implantado. Implante o aplicativo e tente novamente.
404 Associate.Eip.Not.Enough No sufficient EIPs are available. Não há endereços IP elásticos (EIPs) suficientes disponíveis para vinculação. Compre EIPs primeiro.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.