Todos los productos
Search
Centro de documentos

Serverless App Engine:RestartApplication

Última actualización: Sep 01, 2026

Reinicia una aplicación.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

sae:RestartApplication

none

*All Resource

*

Ninguna Ninguna

Sintaxis de la solicitud

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

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

AppId

string

Sí

El ID de la aplicación.

0099b7be-5f5b-4512-a7fc-56049ef1****

MinReadyInstances

integer

No

El número mínimo de instancias disponibles. Valores especiales:

  • Si establece el valor en 0, se producen interrupciones del servicio cuando se actualiza la aplicación.

  • Si establece el valor en **-1**, el número mínimo de instancias disponibles se configura automáticamente con un valor recomendado por el sistema. El valor es el entero más cercano al que se redondea hacia arriba el resultado calculado de la siguiente fórmula: Número actual de instancias × 25%. Por ejemplo, si hay cinco instancias disponibles, el número mínimo de instancias disponibles se calcula mediante la siguiente fórmula: 5 × 25% = 1.25. En este caso, el número mínimo de instancias disponibles es 2.

Nota

Asegúrese de que haya al menos una instancia disponible durante el despliegue y la reversión de la aplicación para evitar interrupciones del servicio.

1

MinReadyInstanceRatio

integer

No

El porcentaje del número mínimo de instancias disponibles. Tenga en cuenta las siguientes reglas:

  • Si establece el valor en -1, el número mínimo de instancias disponibles no se determina en función de este parámetro. Valor predeterminado: -1.

  • Si establece el valor en un número de 0 a 100, el número mínimo de instancias disponibles se calcula mediante la siguiente fórmula: Número actual de instancias × (Valor de MinReadyInstanceRatio × 100%). El valor es el entero más cercano redondeado hacia arriba a partir del resultado calculado. Por ejemplo, si el porcentaje se establece en 50% y hay cinco instancias disponibles, el número mínimo de instancias disponibles es 3.

Nota

Cuando se especifican MinReadyInstance y MinReadyInstanceRatio, y MinReadyInstanceRatio se establece en un número de 0 a 100, el valor de **MinReadyInstanceRatio** tiene prioridad.**** Por ejemplo, si MinReadyInstances se establece en **5** y MinReadyInstanceRatio se establece en 50, el número mínimo de instancias disponibles se define como el entero más cercano redondeado hacia arriba a partir del resultado calculado de la siguiente fórmula: Número actual de instancias × 50%.

-1

AutoEnableApplicationScalingRule

boolean

No

Especifica si se debe habilitar automáticamente una política de escalado automático para la aplicación. Valores válidos:

  • true: habilitado.

  • false: deshabilitado.

false

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los datos devueltos.

RequestId

string

El ID de la solicitud.

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

La información adicional que se devuelve. Tenga en cuenta las siguientes reglas:

  • success: Si la llamada se realiza correctamente, se devuelve success.

  • Un código de error: Si la llamada falla, se devuelve un código de error.

success

TraceId

string

El ID de rastreo que se utiliza para consultar los detalles de la solicitud.

0a98a02315955564772843261e****

Data

object

La respuesta.

ChangeOrderId

string

El ID del proceso de cambio.

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

ErrorCode

string

El código de error devuelto si la solicitud falló. Tenga en cuenta las siguientes reglas:

  • El parámetro ErrorCode no se devuelve si la solicitud se realiza correctamente.

  • Si la llamada falla, se devuelve el parámetro ErrorCode. Para obtener más información, consulte la sección "Códigos de error" de este tema.

Code

string

El código de estado HTTP. Tenga en cuenta las siguientes reglas:

  • 2xx: La llamada se realizó correctamente.

  • 3xx: La llamada se redirigió.

  • 4xx: La llamada falló.

  • 5xx: Se produjo un error del servidor.

200

Success

boolean

Indica si la instancia se reinició correctamente. Tenga en cuenta las siguientes reglas:

  • true

  • false

true

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.