UpdateServiceRollout - - Centre de documentation Alibaba Cloud

Description de l'opération

Remarques sur l'utilisation

Fournir au moins un paramètre : Spécifiez au moins l'un des paramètres Partition, Batch ou Paused.
Stratégies mutuellement exclusives : Vous ne pouvez pas spécifier à la fois les paramètres Partition et Batch dans la même requête.
Effet immédiat : Les mises à jour prennent effet immédiatement et affectent les déploiements de service en cours.
Restauration : Vous pouvez effectuer une restauration en augmentant la valeur de Partition. Cependant, il ne s'agit pas d'un processus automatique et vous devez mettre à jour manuellement l'image du service.
La pause n'affecte pas les paramètres : La mise en pause d'un déploiement ne modifie pas les paramètres Partition ou Batch configurés. Elle suspend uniquement la stratégie de déploiement en cours.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Syntaxe de la requête

PUT /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1

Paramètres de chemin

Paramètre	Type	Requis	Description	Exemple
ClusterId	string	Oui	L'identifiant de la région où se trouve le service. Type : string Obligatoire : Oui Description : L'identifiant de la région où se trouve le service. Exemple : cn-shanghai	cn-shanghai
ServiceName	string	Oui	Le nom du service. Type : string Obligatoire : Oui Description : Le nom du service pour lequel mettre à jour la stratégie de publication. Exemple : my-service	my-service

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
body	object	Non	Le corps de la requête.
Partition	object	Non	La configuration du déploiement par partition. Ce paramètre est mutuellement exclusif avec `Batch`. Type : object Obligatoire : Non Description : La configuration du déploiement par partition. Ce paramètre ajuste les paramètres de la stratégie de partition. Il est mutuellement exclusif avec `Batch`.
Partition	string	Non	Valeur de la partition Type : string Obligatoire : Oui Description : La valeur de la partition. Ce paramètre spécifie le nombre ou le pourcentage de réplicas de l'ancienne version à conserver. Il prend en charge deux formats : Un entier, tel que "5", pour le nombre de réplicas. Un pourcentage, tel que "50 %", pour la proportion de réplicas. Stratégie d'ajustement : L'augmentation de la valeur restaure la version précédente en augmentant le nombre de réplicas de l'ancienne version. La diminution de la valeur poursuit le déploiement en réduisant le nombre de réplicas de l'ancienne version. Définir la valeur sur "0" ou "0 %" termine le déploiement, en remplaçant tous les réplicas de l'ancienne version. Exemple : 30 %	30%
Batch	object	Non	La configuration du déploiement par lots. Ce paramètre est mutuellement exclusif avec `Partition`. Type : object Obligatoire : Non Description : La configuration du déploiement par lots pour ajuster les paramètres de la stratégie par lots. Ce paramètre est mutuellement exclusif avec Partition.
BatchSize	string	Non	Le nombre de réplicas à mettre à jour dans chaque lot. Il peut s'agir d'un entier ou d'un pourcentage. La valeur par défaut est `"25 %"`.	25%
Interval	string	Non	L'intervalle d'attente entre les lots. Les unités prises en charge incluent `s` (secondes), `m` (minutes) et `h` (heures).	60s
Paused	boolean	Non	Définissez sur `true` pour mettre en pause le déploiement ou sur `false` pour le reprendre.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	Le corps de la réponse.
RequestId	string	Un identifiant unique pour la requête. Vous pouvez utiliser cet identifiant de requête pour le dépannage et le suivi.	40325405-579C-4D82****
Message	string	Un message qui indique le résultat de la requête. Les valeurs possibles incluent : "Rollout updated successfully" "Rollout paused successfully" "Rollout resumed successfully"	Rollout updated successfully

Exemples

JSON format

{
  "RequestId": "40325405-579C-4D82****",
  "Message": "Rollout updated successfully"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.