How to customize the ROS stack creation page? - Resource Orchestration Service

Une URL personnalisée permet d'ouvrir une page Create Stack préconfigurée dans la console Resource Orchestration Service (ROS). Elle lance ainsi un processus de création de pile avec des paramètres prédéfinis et réduit les saisies manuelles.

Construire une URL personnalisée

L'exemple suivant construit une URL personnalisée qui configure la page Create Stack avec le préfixe de nom MyStack, un modèle spécifique, un rôle RAM nommé CustomRole et le titre de page Create RAM Role.

Exemple d'URL

Remarque

Consultez cette URL pour voir le résultat.

# The line break is for readability only. Do not add a line break in the actual URL.
https://ros.console.alibabacloud.com/cn-hangzhou/stacks/create?templateType=Example
&templateUrl=https://ros-public-templates.oss-cn-hangzhou.aliyuncs.com/ros-templates/examples/security/ecs-ram-role.yml
&step=2&stackNamePrefix=MyStack&parameters={"RoleName":"CustomRole"}&isSimplified=true&productNavBar=disabled&pageTitle={"zh-cn": "创建RAM角色", "en": "Create RAM Role"}

L'ouverture de cette URL dans un navigateur envoie une requête GET à la console ROS. Celle-ci exploite ensuite les paramètres de requête pour afficher une page de création de pile personnalisée.

La page s'ouvre directement sur l'étape Configure Parameters. Le champ Stack Name affiche par défaut une valeur telle que MyStack_2024-0xxx, le champ RAM Role Name prend la valeur CustomRole et l'éditeur YAML contient les politiques - oss:Get* et - oss:List*.

Structure de l'URL personnalisée

L'URL de l'exemple se compose de deux parties séparées par un point d'interrogation (?).

L'URL de base, qui correspond au chemin d'accès.
```
https://ros.console.alibabacloud.com/cn-hangzhou/stacks/create
```
- Ce chemin pointe vers la page Create Stack de la console ROS.
- Le composant cn-hangzhou indique que la pile est créée dans la région China (Hangzhou). Vous pouvez le remplacer par un autre ID de région. Pour plus d'informations, consultez la rubrique Régions ROS.

Les paramètres de requête.

# The line break is for readability only. Do not add a line break in the actual URL.
step=2&
exampleTemplateUrl=http://ros-template.cn-hangzhou.oss.aliyun-inc.com/ECS_Ram_Role.json&
stackNamePrefix=MyStack&
parameters={"RoleName":"CustomRole"}&
isSimplified=true&
productNavBar=disabled&
pageTitle={"zh-cn": "创建RAM角色", "en": "Create RAM Role"}

Ces paramètres prennent la forme de paires clé-valeur séparées par des esperluettes (&). Chaque paire configure une option définissant l'état initial et l'apparence de la page Create Stack. Le tableau suivant décrit les paramètres de l'exemple. Pour obtenir la liste complète des paramètres pris en charge, reportez-vous à la section Paramètres personnalisés pris en charge.

Paire clé-valeur	Paramètre	Valeur	Description
step=2	step	2	Accède directement à l'étape Configure Parameters.
exampleTemplateUrl=https://ros-public-templates.oss-cn-hangzhou.aliyuncs.com/ros-templates/examples/security/ecs-ram-role.yml	exampleTemplateUrl	https://ros-public-templates.oss-cn-hangzhou.aliyuncs.com/ros-templates/examples/security/ecs-ram-role.yml	Charge le modèle depuis l'URL spécifiée : Rôle RAM pour instance ECS.
stackNamePrefix=MyStack	stackNamePrefix	MyStack	Définit MyStack comme préfixe du nom de la pile.
parameters={"RoleName":"CustomRole"}	parameters	{"RoleName":"CustomRole"}	Attribue la valeur CustomRole au paramètre de modèle `RoleName`.
isSimplified=true	isSimplified	true	Active la page de création simplifiée. Remarque Lorsque le paramètre `isSimplified` prend la valeur `true`, les valeurs `2` et `3` du paramètre `step` restent sans effet.
productNavBar=disabled	productNavBar	disabled	Masque la barre de navigation produit située dans le volet de navigation de gauche.
pageTitle={"zh-cn": "创建RAM角色", "en": "Create RAM Role"}	pageTitle	{"zh-cn": "Create RAM Role", "en": "Create RAM Role"}	Définit Create RAM Role comme titre de la page.

Paramètres personnalisés pris en charge

Paramètre	Type	Description	Détails
step	number	Étape par défaut de l'assistant de création de pile.	Valeurs valides : 0 : Select Template 1 : Configure Parameters 2 : Compliance Precheck 3 : Check and Confirm Remarque Si le paramètre isSimplified vaut `true`, les valeurs `2` et `3` de ce paramètre n'ont aucun effet.
stackName	string	Nom de la pile.	Exemple : MyStack Remarque Spécifiez soit le paramètre `stackName`, soit le paramètre `stackNamePrefix`, mais jamais les deux simultanément.
stackNamePrefix	string	Préfixe du nom de la pile. La partie restante du nom est générée aléatoirement.	Exemple : MyPrefix Remarque Spécifiez soit le paramètre `stackNamePrefix`, soit le paramètre `stackName`, mais pas les deux en même temps.
stackId	string	ID de la pile à cloner.	Exemple : 91062917-1467-4f66-ab7a-f176c3ae** Remarque** Vous ne pouvez spécifier qu'un seul des paramètres suivants : `stackId`, `privateTemplateId`, `exampleTemplateUrl` ou `templateUrl`.
pageTitle	map	Titre de la page personnalisée.	Chaîne au format JSON prenant en charge l'internationalisation. Exemple de valeur : {"zh-cn":"创建服务","en":"Create Service"}.
productNavBar	string	Masque le menu de navigation de gauche lorsque la valeur est `disabled`.	Valeurs valides : Vide (par défaut) : le menu de navigation s'affiche. `disabled` : le menu de navigation est masqué.
disableNavigation	boolean	Indique s'il faut masquer le fil d'Ariane en haut de la page.	Valeurs valides : `true` : le fil d'Ariane est masqué. `false` (par défaut) : le fil d'Ariane s'affiche.
hideTitle	boolean	Indique s'il faut masquer le titre de la page.	Valeurs valides : `true` : le titre de la page est masqué. `false` (par défaut) : le titre de la page s'affiche.
hideStepRow	boolean	Indique s'il faut masquer l'assistant en haut de la page.	Valeurs valides : `true` : l'assistant est masqué. `false` (par défaut) : l'assistant s'affiche.
timeoutMins	number	Délai d'expiration de l'opération sur la pile.	Unité : minutes Valeur par défaut : 60 Plage de valeurs : de 10 à 1440 Exemple : 60
disableRollback	boolean	Indique s'il faut restaurer la pile en cas d'échec de l'opération.	Valeurs valides : `false` : la pile est restaurée en cas d'échec. `true` (par défaut) : la pile n'est pas restaurée en cas d'échec.
showTag	boolean	Indique s'il faut afficher les paramètres de tag.	Valeurs valides : `true` : les paramètres de tag s'affichent. `false` : les paramètres de tag ne s'affichent pas.
privateTemplateId	string	ID d'un modèle présent dans My Templates.	Exemple : 5ecd1e10-b0e9-4389-a565-e4c15efc** Remarque** Vous ne pouvez spécifier qu'un seul des paramètres suivants : `privateTemplateId`, `exampleTemplateUrl`, `templateUrl` ou `stackId`.
privateTemplateVersion	string	Version d'un modèle stocké dans My Templates.	Exemple : v1 Ce paramètre n'est pris en compte que si vous spécifiez le paramètre `privateTemplateId`.
exampleTemplateUrl	string	URL d'un modèle d'exemple.	Exemple : `oss://ros-template/demo` Remarque Vous ne pouvez spécifier qu'un seul des paramètres suivants : `exampleTemplateUrl`, `privateTemplateId`, `templateUrl` ou `stackId`.
templateType	string	Mode de fourniture du modèle.	Valeurs valides : `url` : utilisation d'une URL. `text` : saisie directe du modèle. `my_tpl` : modèles personnels (My Templates). `share_tpl` : modèles partagés (Shared Templates).
templateUrl	string	URL du modèle. ROS analyse le contenu du modèle à partir de cette URL.	L'URL doit pointer vers un modèle hébergé sur un serveur web HTTP ou HTTPS, ou dans un bucket Alibaba Cloud OSS (par exemple, `oss://ros/stack-policy/demo` ou `oss://ros/stack-policy/demo?RegionId=cn-hangzhou`). La taille du fichier de modèle peut atteindre 524 288 octets. Si aucune région OSS n'est précisée, ROS utilise par défaut la région de la pile. Exemple : `oss://ros-template/demo` Remarque Vous ne pouvez spécifier qu'un seul des paramètres suivants : `templateUrl`, `privateTemplateId`, `exampleTemplateUrl` ou `stackId`.
hideTemplateSelector	boolean	Indique s'il faut masquer les options de fourniture du modèle.	Valeurs valides : `true` : les options sont masquées. `false` (par défaut) : les options s'affichent.
parameters	string	Paramètres du modèle.	La valeur attendue est une chaîne au format JSON. Exemple : `{"ZoneId":"cn-beijing-c"}`
createType	string	Type de création.	Valeurs valides : Vide : crée une pile. `import` : importe des ressources.
isSimplified	boolean	Indique s'il faut utiliser la page de création simplifiée.	Valeurs valides : `true` : utilise la page de création simplifiée. `false` (par défaut) : utilise la page de création standard.
tags	map	Tags associés à la pile.	La valeur attendue est une chaîne au format JSON. Exemple : `{"key1": "value1", "key2": "value2"}` Remarque Ce paramètre reste sans effet si le paramètre showTag prend la valeur `false`.
immutableTags	map	Tags immuables, impossibles à modifier après la création de la pile.	La valeur attendue est une chaîne au format JSON. Exemple : `{"key1": "value1", "key2": "value2"}`
notificationURLs	string	URL de rappel destinées à recevoir les notifications d'événements de la pile.	La valeur attendue est une liste de chaînes au format JSON. Exemple : `["url1", "url2"]`
immutableNotificationURLs	string	URL de rappel immuables pour les notifications d'événements de la pile, impossibles à modifier après la création de la pile.	La valeur attendue est une liste de chaînes au format JSON. Exemple : `["url1", "url2"]`