RollbackApplication - - Centre de documentation Alibaba Cloud

Restaure une application.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

sae:RollbackApplication

update

*All Resource

*

Aucune

Syntaxe de la requête

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

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
AppId	string	Oui	L'identifiant de l'application.	017f39b8-dfa4-4e16-a84b-1dcee4b1****
VersionId	string	Oui	L'identifiant de la version de l'application. Appelez l'opération ListAppVersions pour obtenir l'identifiant de la version.	0026ff7f-2b57-4127-bdd0-9bf202bb9****
BatchWaitTime	integer	Non	Le temps d'attente entre les lots. Unité : secondes.	10
MinReadyInstances	integer	Non	Le nombre minimum d'instances disponibles. Prenez note des règles suivantes : Si vous définissez la valeur sur 0, des interruptions de service se produisent lors de la mise à jour de l'application. Si vous définissez la valeur sur -1, le nombre minimum d'instances disponibles est automatiquement défini sur une valeur recommandée par le système. Cette valeur correspond à l'entier le plus proche vers lequel le résultat calculé de la formule suivante est arrondi au supérieur : Nombre actuel d'instances × 25 %. Par exemple, si cinq instances sont disponibles, le nombre minimum d'instances disponibles est calculé à l'aide de la formule suivante : 5 × 25 % = 1,25. Dans ce cas, le nombre minimum d'instances disponibles est de 2. Remarque Assurez-vous qu'au moins une instance est disponible lors du déploiement et de la restauration de l'application afin d'éviter les interruptions de service.	1
MinReadyInstanceRatio	integer	Non	Le pourcentage du nombre minimum d'instances disponibles. Prenez note des règles suivantes : Si vous définissez la valeur sur -1, le nombre minimum d'instances disponibles n'est pas déterminé en fonction de ce paramètre. Valeur par défaut : -1. Si vous définissez la valeur sur un nombre de 0 à 100, le nombre minimum d'instances disponibles est calculé à l'aide de la formule suivante : Nombre actuel d'instances × (Valeur de MinReadyInstanceRatio × 100 %). La valeur correspond à l'entier le plus proche arrondi au supérieur à partir du résultat calculé. Par exemple, si le pourcentage est défini sur 50 % et que cinq instances sont disponibles, le nombre minimum d'instances disponibles est de 3. Remarque Lorsque MinReadyInstance et MinReadyInstanceRatio sont tous deux spécifiés et que MinReadyInstanceRatio est défini sur un nombre de 0 à 100, la valeur de MinReadyInstanceRatio est prioritaire. Par exemple, si MinReadyInstances est défini sur 5 et que MinReadyInstanceRatio est défini sur 50, le nombre minimum d'instances disponibles est défini sur l'entier le plus proche arrondi au supérieur à partir du résultat calculé de la formule suivante : Nombre actuel d'instances × 50 %.	-1
UpdateStrategy	string	Non	La stratégie de déploiement. Si le nombre minimum d'instances disponibles est de 1, la valeur du paramètre UpdateStrategy est une chaîne vide (""). Si le nombre minimum d'instances disponibles est supérieur à 1, spécifiez ce paramètre en fonction de vos besoins. Exemples : Effectuer un déploiement canari pour une instance et déployer les instances restantes en deux lots automatiquement avec un intervalle d'une minute entre le déploiement de chaque instance : `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}` Effectuer un déploiement canari pour une instance et déployer les instances restantes en deux lots manuellement : `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}` Déployer les instances en deux lots automatiquement sans intervalle entre le déploiement de chaque instance : `{"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}` Le tableau suivant décrit les paramètres utilisés dans les instructions précédentes. type : le type de stratégie de déploiement. Valeurs valides : GrayBatchUpdate et BatchUpdate. batchUpdate : la stratégie de déploiement progressif. batch : le nombre de lots de déploiement. releaseType : la méthode de traitement des lots. Valeurs valides : auto et manual. batchWaitTime : l'intervalle entre les lots de déploiement. Unité : secondes. grayUpdate : le nombre de lots de déploiement dans le déploiement progressif après un déploiement canari. Ce paramètre est renvoyé uniquement si le paramètre type est défini sur GrayBatchUpdate.	{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}
AutoEnableApplicationScalingRule	string	Non	Indique si une stratégie de mise à l'échelle automatique doit être activée automatiquement pour l'application. Prenez note des règles suivantes : true : active la stratégie de mise à l'échelle automatique. false : désactive la stratégie de mise à l'échelle automatique.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
RequestId	string	L'identifiant de la requête.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	Le message renvoyé pour l'opération.	success
TraceId	string	L'identifiant de trace utilisé pour interroger les détails de la requête.	0a98a02315955564772843261e****
Data	object	La réponse.
ChangeOrderId	string	L'identifiant du processus de modification.	01db03d3-3ee9-48b3-b3d0-dfce2d88****
IsNeedApproval	boolean	Indique si une approbation est requise lorsqu'un utilisateur RAM effectue un déploiement. Prenez note des règles suivantes : true false	true
ErrorCode	string	Le code d'erreur renvoyé en cas d'échec de la requête. Prenez note des règles suivantes : Le paramètre ErrorCode n'est pas renvoyé si la requête réussit. Si l'appel échoue, le paramètre ErrorCode est renvoyé. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
Code	string	Le code d'état HTTP. Prenez note des règles suivantes : 2xx : l'appel a réussi. 3xx : l'appel a été redirigé. 4xx : l'appel a échoué. 5xx : une erreur de serveur s'est produite.	200
Success	boolean	Indique si l'application a été restaurée avec succès. Prenez note des règles suivantes : true false	true

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.