CreateAScripts - - Centre de documentation Alibaba Cloud

Crée un script programmable.

Description de l'opération

Avant de commencer

Créez une instance ALB édition standard ou améliorée par WAF. Pour plus d'informations, consultez CreateLoadBalancer.

Notes d'utilisation

CreateAScripts est une opération asynchrone. Une fois la requête envoyée, le système renvoie un identifiant de requête, mais le script programmable n'est pas encore créé. La tâche de création se poursuit en arrière-plan. Appelez ListAScripts pour interroger l'état de création du script programmable :

Si le script programmable est dans l'état Creating, le script est en cours de création.
Si le script programmable est dans l'état Available, le script est créé avec succès.

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.

alb:CreateAScripts

create

*LoadBalancer.

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur unique depuis votre client pour chaque requête. ClientToken ne prend en charge que les caractères ASCII.	5A2CFF0E-5718-45B5-9D4D-70B******
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : envoie une requête de test à blanc. Aucun script programmable n'est créé. Le système vérifie si les paramètres requis sont spécifiés, si le format de la requête est valide et si les limites métier sont respectées. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur DryRunOperation est renvoyé. false (par défaut) : envoie une requête normale. Si la vérification réussit, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée.	false
ListenerId	string	Oui	L'identifiant de l'écouteur.	lsn-6hfq3zs0x04ibn****
AScripts	array<object>	Non	La liste des informations sur les scripts programmables.
	array<object>	Non	Les informations du script programmable.
AScriptName	string	Oui	Le nom du script programmable. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_), des traits d'union (-) et des espaces. Il doit commencer par une lettre, un caractère chinois ou un chiffre.	test
Position	string	Non	La position d'exécution du script programmable. Valeurs valides : RequestHead (par défaut) : avant l'exécution des règles de transfert de requête. RequestFoot : après l'exécution des règles de transfert de requête. ResponseHead : avant l'exécution des règles de transfert de réponse.	RequestFoot
Enabled	boolean	Non	Indique si le script programmable doit être activé. Valeurs valides : true : activé. false (par défaut) : désactivé.	false
ScriptContent	string	Oui	Le contenu du script programmable.	if and(match_re($uri, '^/1.txt$'), $arg_type) { rewrite(concat('/1.', $arg_type), 'break') }
ExtAttributes	array<object>	Non	Les attributs étendus.
	object	Non	Les informations d'attribut étendu du script programmable.
AttributeKey	string	Non	La clé d'attribut du script AScript. Valeurs valides : EsDebug uniquement. Lorsqu'une requête contient le paramètre _es_dbg et que sa valeur correspond à la clé configurée ici, les en-têtes de réponse de débogage correspondants sont activés pour générer les enregistrements d'exécution des règles.	EsDebug
AttributeValue	string	Non	La valeur de l'attribut. La valeur peut contenir des lettres majuscules et minuscules ainsi que des chiffres, et doit comporter entre 1 et 128 caractères.	test123
ExtAttributeEnabled	boolean	Non	Indique si les attributs étendus du script programmable doivent être activés. Valeurs valides : true : activé. false (par défaut) : désactivé.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse pour la création d'un script programmable.
JobId	string	L'identifiant de la tâche asynchrone.	5c607642-535e-4e06-9d77-df53049b****
RequestId	string	L'identifiant de la requête.	BF0FE763-9603-558F-A55B-0F4******
AScriptIds	array<object>	La liste des identifiants de script programmable.
	object	L'identifiant du script programmable.
AScriptId	string	L'identifiant du script programmable.	as-xvq5igaa7uv6vr****

Exemples

JSON format

{
  "JobId": "5c607642-535e-4e06-9d77-df53049b****",
  "RequestId": "BF0FE763-9603-558F-A55B-0F4******",
  "AScriptIds": [
    {
      "AScriptId": "as-xvq5igaa7uv6vr****"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IncorrectStatus.Listener	The status of %s [%s] is incorrect.	L'état actuel de l'écouteur ne prend pas en charge cette opération.
400	ResourceQuotaExceeded.AScriptsNum	The quota of %s is exceeded for resource %s, usage %s/%s.	Le quota %s a été dépassé. L'utilisation actuelle est de %s et le quota est de %s.
400	ResourceQuotaExceeded.AScriptsTotalLinesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	Le quota %s a été dépassé. L'utilisation actuelle est de %s et le quota est de %s.
400	ResourceQuotaExceeded.AScriptLinesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	Le quota %s a été dépassé. L'utilisation actuelle est de %s et le quota est de %s.

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

Notes de version

Consultez Notes de version pour la liste complète.