CreateRule - - Centre de documentation Alibaba Cloud

Crée une règle de transfert pour un écouteur spécifié.

Description de l'opération

Lorsque vous appelez cette opération pour créer une règle de transfert, tenez compte des points suivants :

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:CreateRule

create

*LoadBalancer

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

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ListenerId	string	Oui	L'identifiant de l'écouteur de l'instance Application Load Balancer (ALB).	lsn-l16uo9y******
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que ce jeton est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement la valeur de RequestId comme valeur de ClientToken. La valeur de RequestId est différente pour chaque requête API.	5A2CFF0E-5718-45B5-9D4D-70B******
DryRun	boolean	Non	Indique si un test à blanc uniquement doit être effectué, sans exécuter la requête réelle. Valeurs valides :\n\n- true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètres manquantes, une syntaxe de requête incorrecte et les limites de service. Si la requête échoue au test à blanc, un code d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur `DryRunOperation` est renvoyé.\n\n- false (par défaut) : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état `HTTP 2xx` est renvoyé et l'opération est exécutée.	false
Priority	integer	Oui	La priorité de la règle de transfert. Valeurs valides : 1 à 10000. Une valeur plus petite indique une priorité plus élevée. Remarque La priorité de chaque règle au sein d'un écouteur doit être unique.	10
Direction	string	Non	La direction de la règle de transfert. Valeurs valides : Request (par défaut) : La règle s'applique aux requêtes envoyées par les clients vers l'ALB et exécute les actions correspondantes. Response : La règle s'applique aux réponses renvoyées par les groupes de serveurs backend vers l'ALB et exécute les actions correspondantes. Remarque Les instances ALB de l'Édition de base ne prennent pas en charge le type Response.	Request
RuleActions	array<object>	Oui	La liste des actions des règles de transfert.
	array<object>	Oui	La liste des actions de règle.
FixedResponseConfig	object	Non	La configuration de la réponse fixe.
Content	string	Non	Le contenu fixe à renvoyer. Le contenu peut avoir une taille maximale de 1 Ko et ne peut contenir que des caractères ASCII.	dssacav
ContentType	string	Non	Le format du contenu fixe. Valeurs valides : text/plain, text/css, text/html, application/javascript et application/json.	text/plain
HttpCode	string	Non	Le code de réponse HTTP à renvoyer. Seules les chaînes numériques 2xx, 4xx et 5xx sont prises en charge, où x représente n'importe quel chiffre.	200
ForwardGroupConfig	object	Non	La liste des groupes de serveurs de destination vers lesquels les requêtes sont transférées. Un maximum de 5 groupes de serveurs de destination peut être ajouté à une règle de transfert.
ServerGroupTuples	array<object>	Non	La liste des groupes de serveurs de destination vers lesquels les requêtes sont transférées. Un maximum de 5 groupes de serveurs de destination peut être ajouté à une règle de transfert.
	object	Non	La structure du groupe de serveurs de destination.
ServerGroupId	string	Non	The destination server group to which requests are forwarded.	sgp-k86c1ov501id6p****
Weight	integer	Non	The weight. A larger value indicates a higher weight, which means more requests are forwarded to the server group. Valid values: 0 to 100. If only one destination server group is specified and no weight is specified, the default value is 100. If more than one destination server group is specified, you must specify the weight value.	100
ServerGroupStickySession	object	Non	La configuration de la persistance de session entre les groupes de serveurs.
Enabled	boolean	Non	Specifies whether to enable session persistence. Valid values: true: enabled. false (default): disabled.	false
Timeout	integer	Non	The timeout period. Unit: seconds. Valid values: 1 to 86400. Default value: 1000.	100
InsertHeaderConfig	object	Non	La configuration pour l'insertion d'un champ d'en-tête.
Key	string	Non	Le nom du champ d'en-tête à insérer. Le nom doit comporter de 1 à 40 caractères et peut contenir des lettres minuscules et majuscules de a à z, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom du champ d'en-tête spécifié dans InsertHeaderConfig doit être unique. Remarque Vous ne pouvez pas utiliser les champs suivants comme nom d'en-tête (insensible à la casse) : `slb-id`, `slb-ip`, `x-forwarded-for`, `x-forwarded-proto`, `x-forwarded-eip`, `x-forwarded-port`, `x-forwarded-client-srcport`, `connection`, `upgrade`, `content-length`, `transfer-encoding`, `keep-alive`, `te`, `host`, `cookie`, `remoteip`, `authority`, `x-forwarded-host`.	key
Value	string	Non	La valeur du champ d'en-tête à insérer. Si ValueType est défini sur SystemDefined, les valeurs valides sont : ClientSrcPort : le port client. ClientSrcIp : l'adresse IP du client. Protocol : le protocole utilisé par la requête client (HTTP ou HTTPS). SLBId : l'identifiant de l'instance Application Load Balancer. SLBPort : le port d'écoute de l'instance Application Load Balancer. Si ValueType est défini sur UserDefined : vous pouvez spécifier une valeur d'en-tête personnalisée. La valeur doit comporter de 1 à 128 caractères et peut contenir des caractères génériques tels que les astérisques (), les points d'interrogation (?), ainsi que des caractères imprimables dans la plage ASCII `ch >= 32 && ch < 127`. La valeur ne peut pas contenir `"`. La valeur ne peut pas commencer ou se terminer par un espace. La valeur ne peut pas se terminer par `\`. Si ValueType* est défini sur ReferenceHeader : vous pouvez référencer un champ dans l'en-tête de la requête. La valeur doit comporter de 1 à 128 caractères et peut contenir des lettres minuscules de a à z, des chiffres, des traits d'union (-) et des traits de soulignement (_).	UserDefined
ValueType	string	Non	Le type de contenu de la valeur du champ d'en-tête. Valeurs valides : UserDefined : une valeur personnalisée. ReferenceHeader : fait référence à un champ de l'en-tête de la requête. SystemDefined : une valeur définie par le système.	UserDefined
Order	integer	Oui	L'ordre dans lequel l'action de la règle de transfert est exécutée. Valeurs valides : 1 à 50000. Les actions sont exécutées par ordre croissant de valeurs. Ce paramètre ne peut pas être laissé vide et la valeur ne peut pas être dupliquée.	1
RedirectConfig	object	Non	La configuration de redirection. Remarque Pour les paramètres de RedirectConfig, les paramètres autres que httpCode ne peuvent pas tous utiliser les valeurs par défaut.
Host	string	Non	L'hôte vers lequel les requêtes sont redirigées. Valeurs valides : ${host} (par défaut) : Cette valeur ne peut pas être concaténée avec d'autres caractères. Autres valeurs. Les restrictions de jeu de caractères et de format sont les suivantes : Le nom d'hôte doit comporter de 3 à 256 caractères et peut contenir des lettres minuscules de a à z, des chiffres, des traits d'union (-), des points (.) ainsi que les caractères génériques astérisques (), signes égal (=), tildes (~), traits de soulignement (_), signes plus (+), barres obliques inverses (\), accents circonflexes (^), points d'exclamation (!), signes dollar ($), esperluettes (&), barres verticales (\|), parenthèses (()), crochets ([]) et points d'interrogation (?). Le nom d'hôte doit contenir au moins un point (.) et ne peut ni commencer ni se terminer par un point (.). L'étiquette de domaine la plus à droite ne peut contenir que des lettres et des caractères génériques, et ne peut pas contenir de chiffres ni de traits d'union (-). Le `domainlable` le plus à gauche peut être un astérisque (). Les traits d'union (-) ne peuvent pas apparaître au début ou à la fin des autres étiquettes de domaine. Les astérisques (*) et les points d'interrogation (?) peuvent apparaître à n'importe quelle position dans une étiquette de domaine.	${host}
HttpCode	string	Non	Le type de redirection. Valeurs valides : 301, 302, 303, 307 et 308.	301
Path	string	Non	Le chemin vers lequel les requêtes sont redirigées. Valeurs valides : ${path} (par défaut) : Vous pouvez référencer ${host}, ${protocol} et ${port}. Chaque variable peut apparaître au maximum une fois. Ces variables peuvent être utilisées ensemble ou concaténées avec des caractères appartenant au jeu de caractères autorisé décrit ci-dessous. Autres valeurs. Les restrictions relatives au jeu de caractères et au format sont les suivantes : La valeur doit comporter entre 1 et 256 caractères, respecter la casse et prendre en charge les astérisques () et les points d'interrogation (?) comme caractères génériques. La valeur doit commencer par une barre oblique (/) et peut contenir des lettres majuscules et minuscules, des chiffres et les caractères spéciaux `$-_.+/&~@:'?`. La valeur ne peut pas contenir `"%#;!()[]^,"\"`. Les astérisques (*) et les points d'interrogation (?) sont pris en charge comme caractères génériques.	/test
Port	string	Non	Le port vers lequel les requêtes sont redirigées. ${port} (par défaut) : Cette valeur ne peut pas être utilisée avec d'autres caractères. Autres valeurs : 1 à 63335.	10
Protocol	string	Non	Le protocole vers lequel les requêtes sont redirigées. Valeurs valides : ${protocol} (par défaut) : cette valeur ne peut être utilisée que seule et ne peut pas être modifiée ni concaténée avec d'autres caractères. HTTP HTTPS Remarque Les écouteurs HTTPS prennent en charge la redirection vers HTTPS uniquement. Les écouteurs HTTP prennent en charge la redirection vers HTTP et HTTPS.	HTTP
Query	string	Non	La chaîne de requête vers laquelle les requêtes sont redirigées. ${query} (par défaut) : vous pouvez référencer ${host}, ${protocol} et ${port}. Chaque variable ne peut apparaître qu'une seule fois. Ces variables peuvent être utilisées ensemble ou concaténées avec des caractères appartenant au jeu de caractères autorisé décrit ci-dessous. Autres valeurs. Les restrictions relatives au jeu de caractères et au format sont les suivantes : La valeur doit comporter de 1 à 128 caractères. La valeur peut contenir des caractères imprimables, mais ne peut pas contenir d'espaces ni les caractères `#[]{}\\|<>"`. Les lettres doivent être en minuscules.	${query}
RewriteConfig	object	Non	La configuration de réécriture. Remarque Lorsque vous configurez plusieurs actions pour une règle de transfert, l'action RewriteConfig doit être utilisée conjointement avec le type d'action ForwardGroup.
Host	string	Non	Le nom d'hôte de destination pour la redirection interne. Valeurs valides : ${host} (par défaut) : Cette valeur ne peut pas être concaténée avec d'autres caractères. Autres valeurs. Les restrictions de jeu de caractères et de format sont les suivantes : Le nom d'hôte doit comporter de 3 à 256 caractères et peut contenir des lettres minuscules de a à z, des chiffres, des traits d'union (-), des points (.), ainsi que les caractères génériques astérisques (), signes égal (=), tildes (~), traits de soulignement (_), signes plus (+), barres obliques inverses (\), accents circonflexes (^), points d'exclamation (!), signes dollar ($), esperluettes (&), barres verticales (\|), parenthèses (()), crochets ([]) et points d'interrogation (?). Le nom d'hôte doit contenir au moins un point (.) et ne peut ni commencer ni se terminer par un point (.). L'étiquette de domaine la plus à droite ne peut contenir que des lettres et des caractères génériques, et ne peut pas contenir de chiffres ni de traits d'union (-). Le domainlable le plus à gauche peut être un astérisque (). Les traits d'union (-) ne peuvent pas apparaître au début ou à la fin des autres étiquettes de domaine. Les caractères génériques astérisques (*) et points d'interrogation (?) peuvent apparaître à n'importe quelle position dans une étiquette de domaine.	www.example.com
Path	string	Non	Le chemin vers lequel les requêtes sont redirigées. Valeurs valides : ${path} (par défaut) : vous pouvez référencer ${host}, ${protocol} et ${port}. Chaque variable peut apparaître au maximum une fois. Ces variables peuvent être utilisées ensemble ou concaténées avec des caractères appartenant au jeu de caractères autorisé décrit ci-dessous. Autres valeurs. Les restrictions relatives au jeu de caractères et au format sont les suivantes : La valeur doit comporter entre 1 et 256 caractères, respecte la casse et prend en charge les caractères génériques astérisque () et point d'interrogation (?). La valeur doit commencer par une barre oblique (/) et peut contenir des lettres majuscules et minuscules, des chiffres et les caractères spéciaux `$-_.+/&~@:'?`. La valeur ne peut pas contenir `"%#;!()[]^,"\"`. Les caractères génériques astérisque (*) et point d'interrogation (?) sont pris en charge.	/tsdf
Query	string	Non	La chaîne de requête pour la redirection interne. ${query} (par défaut) : vous pouvez faire référence à ${host}, ${protocol} et ${port}. Chaque variable ne peut apparaître qu'une seule fois. Ces variables peuvent être utilisées ensemble ou concaténées avec des caractères du jeu de caractères autorisé décrit ci-dessous. Autres valeurs. Les restrictions relatives au jeu de caractères et au format sont les suivantes : La valeur doit comporter de 1 à 128 caractères. La valeur peut contenir des caractères imprimables, mais ne peut pas contenir d'espaces ni `#[]{}\\|<>"`. Les lettres doivent être en minuscules.	${query}
Type	string	Oui	Le type d'action. Valeurs valides : ForwardGroup : transfère les requêtes vers plusieurs services virtuels. Redirect : redirige les requêtes. FixedResponse : renvoie une réponse fixe. Rewrite : réécrit les requêtes. InsertHeader : insère un champ d'en-tête. RemoveHeader : supprime un champ d'en-tête. TrafficLimit : limite le trafic. TrafficMirror : met en miroir le trafic. Cors : active le partage de ressources cross-origin (CORS). Remarque Une règle de transfert doit contenir une action ForwardGroup (transférer vers), Redirect (rediriger) ou FixedResponse (renvoyer une réponse fixe). Lorsque cette action coexiste avec d'autres types d'actions, elle doit être exécutée en dernier.	ForwardGroup
TrafficLimitConfig	object	Non	La configuration de la limitation du trafic.
QPS	integer	Non	Le nombre de requêtes par seconde. Valeurs valides : 1 à 1000000.	100
PerIpQps	integer	Non	Le nombre de requêtes par seconde et par adresse IP. Valeurs valides : 1 à 1000000. Remarque Si vous configurez à la fois les paramètres QPS et PerIpQps, la valeur de PerIpQps doit être inférieure à la valeur de QPS.	80
TrafficMirrorConfig	object	Non	La configuration de la mise en miroir du trafic.
TargetType	string	Non	Le type de la cible de mise en miroir. Valeurs valides :\n- ForwardGroupMirror : met en miroir le trafic vers un groupe de serveurs.	ForwardGroupMirror
MirrorGroupConfig	object	Non	La configuration pour la mise en miroir du trafic vers un groupe de serveurs.
ServerGroupTuples	array<object>	Non	The configuration for mirroring traffic to a server group.
	object	Non	The configuration for mirroring traffic to a server group.
ServerGroupId	string	Non	The server group ID.	sgp-00mkgijak0w4qgz9****
RemoveHeaderConfig	object	Non	La configuration pour la suppression d'un champ d'en-tête HTTP.
Key	string	Non	Le nom du champ d'en-tête à supprimer. Le nom doit comporter de 1 à 40 caractères et peut contenir des lettres majuscules et minuscules de a à z, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom du champ d'en-tête ne peut pas être dupliqué dans RemoveHeader. Direction de la requête (Direction est définie sur Request) : vous ne pouvez pas définir le nom de l'en-tête sur les champs suivants (insensible à la casse) : `slb-id`, `slb-ip`, `x-forwarded-for`, `x-forwarded-proto`, `x-forwarded-eip`, `x-forwarded-port`, `x-forwarded-client-srcport`, `connection`, `upgrade`, `content-length`, `transfer-encoding`, `keep-alive`, `te`, `host`, `cookie`, `remoteip`, `authority`, `x-forwarded-host`. Direction de la réponse (Direction est définie sur Response) : vous ne pouvez pas définir le nom de l'en-tête sur les champs suivants (insensible à la casse) : `connection`, `upgrade`, `content-length`, `transfer-encoding`.	test
CorsConfig	object	Non	La configuration CORS.
AllowOrigin	array	Non	La liste des origines autorisées. Vous pouvez configurer un élément unique ``, ou configurer une ou plusieurs valeurs. Chaque valeur doit commencer par `http://` ou `https://`, suivie d'un nom de domaine valide ou d'un nom de domaine générique de premier niveau (par exemple, `http://.test.abc.example.com`). Chaque valeur peut éventuellement inclure un port. La plage de ports va de 1 à 65535.
	string	Non	L'origine autorisée.	http://example.com
AllowMethods	array	Non	Les méthodes HTTP autorisées pour les requêtes CORS.
	string	Non	La méthode HTTP autorisée pour les requêtes CORS. Valeurs valides : GET. POST. PUT. DELETE. HEAD. OPTIONS. PATCH.	GET
AllowHeaders	array	Non	La liste des en-têtes autorisés pour les requêtes CORS.
	string	Non	L'en-tête autorisé pour les requêtes CORS. Vous pouvez le définir sur `*` ou configurer une ou plusieurs valeurs séparées par des virgules (,). Chaque valeur ne peut contenir que des lettres majuscules et minuscules, des chiffres, ainsi que des traits de soulignement (_) et des traits d'union (-) ne figurant ni au début ni à la fin. La longueur maximale de chaque valeur est de 32 caractères.	test_123
ExposeHeaders	array	Non	La liste des en-têtes pouvant être exposés.
	string	Non	L'en-tête pouvant être exposé. Vous pouvez le définir sur `*` ou configurer une ou plusieurs valeurs séparées par des virgules (,). Chaque valeur ne peut contenir que des lettres majuscules et minuscules, des chiffres, ainsi que des traits de soulignement (_) et des traits d'union (-) ne figurant ni au début ni à la fin. La longueur maximale de chaque valeur est de 32 caractères.	test_123
AllowCredentials	string	Non	Indique si les informations d'identification sont autorisées. Valeurs valides : on : autorisé. off : non autorisé.	on
MaxAge	integer	Non	La durée maximale de mise en cache des requêtes preflight dans le navigateur. Unité : secondes. Valeurs valides : -1 à 172800.	1000
RuleConditions	array<object>	Oui	La liste des conditions de la règle de transfert.
	array<object>	Oui	La condition de la règle de transfert.
CookieConfig	object	Non	La configuration du cookie.
Values	array<object>	Non	La liste des valeurs de cookie.
	object	Non	La structure de valeur de cookie.
Key	string	Non	The cookie key. The value must be 1 to 100 characters in length. The value can contain printable characters, wildcards asterisks (*), and question marks (?). Letters must be lowercase. The value cannot contain spaces or `;#[]{}\\|<>&"`.	test
Value	string	Non	The cookie value. The value must be 1 to 100 characters in length. The value can contain printable characters, wildcards asterisks (*), and question marks (?). Letters must be lowercase. The value cannot contain spaces or `;#[]{}\\|<>&"`.	test
HeaderConfig	object	Non	La configuration du champ d'en-tête.
Key	string	Non	La clé du champ d'en-tête. La valeur doit comporter entre 1 et 40 caractères. La valeur peut contenir des lettres de a à z, des chiffres, des traits d'union (-) et des traits de soulignement (_). Cookie et Host ne sont pas pris en charge.	Port
Values	array	Non	La liste des valeurs du champ d'en-tête.
	string	Non	La liste des valeurs d'en-tête HTTP. Les valeurs des champs d'en-tête au sein d'une même condition de règle de transfert ne peuvent pas être dupliquées. La valeur doit comporter de 1 à 128 caractères. La valeur peut contenir des caractères imprimables dans la plage ASCII `ch >= 32 && ch < 127`, des astérisques (*) et des points d'interrogation (?). La valeur ne peut pas contenir `"`. La valeur ne peut pas commencer ou se terminer par un espace. La valeur ne peut pas se terminer par `\`.	5006
HostConfig	object	Non	La configuration du nom d'hôte.
Values	array	Non	La liste des noms d'hôte.
	string	Non	Le nom d'hôte. Un seul nom d'hôte peut être spécifié dans une condition de règle de transfert, et la valeur ne peut pas être dupliquée. Le nom d'hôte doit comporter de 3 à 256 caractères et peut contenir des lettres minuscules de a à z, des chiffres de 0 à 9, des traits d'union (-), des points (.), des astérisques (), des signes égal (=), des tildes (~), des traits de soulignement (_), des signes plus (+), des barres obliques inverses (\), des accents circonflexes (^), des points d'exclamation (!), des signes dollar ($), des esperluettes (&), des barres verticales (\|), des parenthèses (()), des crochets ([]) et des points d'interrogation (?). Le nom d'hôte doit contenir au moins un point (.) et ne peut pas commencer ou se terminer par un point (.). L'étiquette de domaine la plus à droite ne peut contenir que des lettres et des caractères génériques, et ne peut pas contenir de chiffres ou de traits d'union (-). L'étiquette de domaine la plus à gauche peut être un astérisque (). Les traits d'union (-) ne peuvent pas apparaître au début ou à la fin des autres étiquettes de domaine. Les caractères génériques astérisque () et point d'interrogation (?) peuvent apparaître à n'importe quelle position dans une étiquette de domaine. Pour le champ de saisie <correspondance exacte et caractère générique>, le premier caractère ne peut pas être un tilde (~). Pour le champ de saisie d'expression régulière (<correspondance d'expression régulière insensible à la casse>), le premier caractère ne peut pas être un astérisque ().	www.example.edu
MethodConfig	object	Non	La configuration de la méthode de requête.
Values	array	Non	La liste des méthodes de requête.
	string	Non	La méthode de requête. Valeurs valides : HEAD, GET, POST, OPTIONS, PUT, PATCH et DELETE.	PUT
PathConfig	object	Non	La configuration du chemin de transfert.
Values	array	Non	La liste des chemins de transfert.
	string	Non	Le chemin de transfert. Valeurs valides : La valeur doit comporter de 1 à 256 caractères, respecter la casse et prendre en charge les astérisques () et les points d'interrogation (?) comme caractères génériques. Pour les URL sans expression régulière, la valeur doit commencer par une barre oblique (/) et peut contenir des lettres, des chiffres et les caractères spéciaux `$-_.+/&~@:'?`. La valeur ne peut pas contenir `"%#;!()[]^,"\"`. Les astérisques () et les points d'interrogation (?) sont pris en charge comme caractères génériques. Pour les URL avec expression régulière, la valeur doit commencer par un tilde (~) et peut contenir des lettres majuscules et minuscules, des chiffres et les caractères spéciaux `.-_/=?~^$:()[]+\|`.	/test
QueryStringConfig	object	Non	La configuration de la chaîne de requête.
Values	array<object>	Non	La liste des chaînes de requête.
	object	Non	La chaîne de requête.
Key	string	Non	The query string key. The value must be 1 to 100 characters in length. The value can contain printable characters, wildcards asterisks (*), and question marks (?). Letters must be lowercase. The value cannot contain spaces or `#[]{}\\|<>&"`.	test
Value	string	Non	The query string value. The value must be 1 to 128 characters in length. The value can contain lowercase letters, printable characters, wildcards asterisks (*), and question marks (?). The value cannot contain spaces or `#[]{}\\|<>&"`.	test
ResponseStatusCodeConfig	object	Non	La configuration du code d'état de la réponse.
Values	array	Non	La liste des codes d'état de la réponse.
	string	Non	Le code d'état de la réponse.	test
ResponseHeaderConfig	object	Non	La configuration de l'en-tête de réponse.
Key	string	Non	La clé du champ d'en-tête. La clé doit comporter entre 1 et 40 caractères. La clé peut contenir des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_). Cookie et Host ne sont pas pris en charge.	test
Values	array	Non	La liste des valeurs du champ d'en-tête.
	string	Non	La valeur du champ d'en-tête. La valeur doit comporter entre 1 et 128 caractères. La valeur peut contenir des caractères imprimables dans la plage ASCII `ch >= 32 && ch < 127`, des lettres minuscules, ainsi que les caractères génériques astérisque (*) et point d'interrogation (?). La valeur ne peut pas contenir `"`. La valeur ne peut ni commencer ni se terminer par un espace. La valeur ne peut pas se terminer par `\`.	50006
Type	string	Oui	Le type de la règle de transfert. Valeurs valides : Host : hôte. Path : chemin. Header : champ d'en-tête HTTP. QueryString : chaîne de requête. Method : méthode de requête. Cookie : cookie. SourceIp : adresse IP source. ResponseHeader : champ d'en-tête HTTP de réponse. ResponseStatusCode : code d'état de la réponse.	Host
SourceIpConfig	object	Non	La configuration de la correspondance du trafic de service basée sur l'IP source. Ce paramètre est requis et ne prend effet que lorsque Type est défini sur SourceIP.
Values	array	Non	La liste des adresses IP source pour la correspondance du trafic de service.
	string	Non	Une ou plusieurs adresses IP ou blocs CIDR.	192.168.0.0/32
RuleName	string	Oui	Le nom de la règle de transfert. \n- Le nom doit comporter de 2 à 128 caractères.\n- Le nom doit commencer par une lettre, un caractère chinois ou un chiffre. Il peut contenir des chiffres, des points (.), des traits de soulignement (_), des traits d'union (-) et des espaces.	rule-doc
Tag	array<object>	Non	La liste des balises.
	object	Non	La structure de la balise.
Key	string	Non	La clé de la balise. La clé de la balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.	env
Value	string	Non	La valeur de la balise. La valeur de la balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.	product

Éléments de réponse

Élément	Type	Description	Exemple
	object	La structure de la réponse.
JobId	string	L'identifiant de la tâche asynchrone.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	L'identifiant de la requête.	365F4154-92F6-4AE4-92F8-7FF34B540750
RuleId	string	L'identifiant de la règle de transfert.	rule-a3x3pg1yohq3lq****

Exemples

JSON format

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540750",
  "RuleId": "rule-a3x3pg1yohq3lq****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IncorrectStatus.Listener	The status of %s [%s] is incorrect.
400	OperationDenied.SameGroupForForwardAndMirrorAction	The operation is not allowed because of %s.	The operation is not allowed because of %s.
400	OperationDenied.IpGroupCanNotUsedForMirrorAction	The operation is not allowed because of %s.	The operation is not allowed because of %s.
400	OperationDenied.GRPCServerGroup	The operation is not allowed because of %s.
400	Conflict.Priority	There is already %s having the same configuration with %s.
400	ResourceQuotaExceeded.LoadBalancerRulesNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	ResourceQuotaExceeded.ServerGroupAttachedNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	ResourceQuotaExceeded.LoadBalancerServersNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	ResourceQuotaExceeded.ServerAddedNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	QuotaExceeded.RuleWildcardsNum	The quota of %s is exceeded, usage %s/%s.	The quota of %s is exceeded, usage %s/%s.
400	QuotaExceeded.RuleMatchEvaluationsNum	The quota of %s is exceeded, usage %s/%s.
400	QuotaExceeded.RuleActionsNum	The quota of %s is exceeded, usage %s/%s.	The quota of %s is exceeded. Usage: %s/%s.
400	Mismatch.Protocol	The %s is mismatched for %s and %s.	The %s is mismatched for %s and %s.
400	Mismatch.VpcId	The %s is mismatched for %s and %s.	The %s is mismatched for %s and %s.
400	OperationDenied.RewriteMissingForwardGroup	The operation is not allowed because of RewriteMissingForwardGroup.	The operation is not allowed because rewrite is missing the forward group.
400	ResourceInConfiguring.Listener	The specified listener is being configured, please try again later.
400	OperationDenied.MirrorActionSupportHttpGroupOnly	The operation is not allowed because of MirrorActionSupportHttpGroupOnly.
400	OperationDenied.ProtocolMustSameForForwardGroupAction	The operation is not allowed because of ProtocolMustSameForForwardGroupAction.
404	ResourceNotFound.Listener	The specified resource %s is not found.
404	ResourceNotFound.ServerGroup	The specified resource %s is not found.

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

Notes de version

Consultez Notes de version pour la liste complète.