Consulte les règles de transfert dans une région spécifiée.
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
|
alb:ListRules |
get |
*LoadBalancer.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| NextToken |
string |
Non |
Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Valeurs valides :
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| MaxResults |
integer |
Non |
Le nombre maximal d'enregistrements de données à lire dans cette requête.\n\nValeurs valides : 1 à 100.\n\nValeur par défaut : 20, ce qui indique qu'aucune valeur n'est spécifiée.\n\n> Ce paramètre est facultatif. |
20 |
| RuleIds |
array |
Non |
La liste des règles de transfert. Vous pouvez interroger jusqu'à 20 règles de transfert à la fois. |
|
|
string |
Non |
L'identifiant de la règle de transfert. |
rule-sada****** |
|
| ListenerIds |
array |
Non |
La liste des identifiants d'écouteurs. Vous pouvez interroger jusqu'à 20 écouteurs à la fois. |
|
|
string |
Non |
L'identifiant de l'écouteur. |
lsn-i35udpz3pxsmnf**** |
|
| LoadBalancerIds |
array |
Non |
La liste des identifiants d'instances d'équilibrage de charge. Vous pouvez interroger jusqu'à 20 instances à la fois. |
|
|
string |
Non |
L'identifiant de l'instance d'équilibreur de charge. |
alb-x30o38azsuj0sx**** |
|
| Direction |
string |
Non |
La direction de la règle de transfert. Valeurs valides :
Remarque
Les instances ALB Basic Edition ne prennent pas en charge le type Response. |
Request |
| Tag |
array<object> |
Non |
Les balises. |
|
|
object |
Non |
La structure de balise. |
||
| Key |
string |
Non |
La clé de balise. La clé de 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 balise. La valeur de 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 règle de transfert. |
||
| MaxResults |
integer |
Le nombre maximal d'enregistrements renvoyés pour cette requête. |
50 |
| NextToken |
string |
Indique si une requête suivante existe. Valeurs valides :
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| RequestId |
string |
L'identifiant de la requête. |
CEF72CEB-54B6-4AE8-B225-F876F****** |
| Rules |
array<object> |
La liste des règles de transfert. |
|
|
array<object> |
La structure de la règle de transfert. |
||
| ListenerId |
string |
L'identifiant de l'écouteur auquel la règle de transfert appartient. |
lsn-i35udpz3pxsmnf**** |
| LoadBalancerId |
string |
L'identifiant de l'instance d'équilibrage de charge à laquelle la règle de transfert appartient. |
alb-x30o38azsuj0sx**** |
| Priority |
integer |
La priorité de la règle. Valeurs valides : 1 à 10000. Une valeur plus petite indique une priorité plus élevée. Remarque
Les priorités des règles doivent être uniques au sein du même écouteur. |
1 |
| RuleActions |
array<object> |
La liste des actions de la règle de transfert. |
|
|
array<object> |
La structure de l'action de la règle de transfert. |
||
| FixedResponseConfig |
object |
La configuration de la réponse fixe. |
|
| Content |
string |
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 |
Le format du contenu fixe à renvoyer. Valeurs valides : text/plain, text/css, text/html, application/javascript et application/json. |
text/plain |
| HttpCode |
string |
Le code de réponse HTTP à renvoyer. Seules les chaînes numériques au format HTTP_2xx, HTTP_4xx et HTTP_5xx sont prises en charge, où x représente n'importe quel chiffre. |
HTTP_2xx |
| ForwardGroupConfig |
object |
La configuration du groupe de transfert. |
|
| ServerGroupTuples |
array<object> |
La liste des groupes de serveurs de destination vers lesquels les requêtes sont transférées. |
|
|
object |
La liste des groupes de serveurs de destination vers lesquels les requêtes sont transférées. |
||
| ServerGroupId |
string |
L'identifiant du groupe de serveurs de destination vers lequel les requêtes sont transférées. |
sgp-atstuj3rtoptyui**** |
| Weight |
integer |
Le poids. Valeurs valides : 0 à 100. |
2 |
| ServerGroupStickySession |
object |
La configuration de la persistance de session entre les groupes de serveurs. |
|
| Enabled |
boolean |
Indique si la persistance de session entre les groupes de serveurs doit être activée lorsque plusieurs groupes de serveurs sont spécifiés. |
true |
| Timeout |
integer |
Le délai d'expiration de la persistance de session lorsque Enabled est défini sur true. Unité : secondes. Valeurs valides : 1 à 86400. |
100 |
| InsertHeaderConfig |
object |
La configuration du champ d'en-tête à insérer. |
|
| Key |
string |
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 ne peut pas être utilisé plus d'une fois dans InsertHeader. Remarque
Vous ne pouvez pas utiliser Cookie ou Host comme nom de champ d'en-tête. |
key |
| Value |
string |
Le contenu du champ d'en-tête à insérer.
|
ClientSrcPort |
| ValueType |
string |
Le type de contenu du champ d'en-tête. Valeurs valides :
|
SystemDefined |
| Order |
integer |
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 valeur. La valeur ne peut pas être vide ni dupliquée. |
1 |
| RedirectConfig |
object |
La configuration de la redirection. |
|
| Host |
string |
L'adresse d'hôte vers laquelle rediriger. Valeurs valides :
|
www.example.com |
| HttpCode |
string |
Le type de redirection. Valeurs valides : 301, 302, 303, 307 et 308. |
301 |
| Path |
string |
Le chemin vers lequel rediriger. Valeurs valides :
|
/test |
| Port |
string |
Le port vers lequel rediriger. Valeurs valides :
|
10 |
| Protocol |
string |
Le protocole vers lequel rediriger. Valeurs valides :
Remarque
Les écouteurs HTTPS ne prennent en charge que les redirections vers HTTPS. |
HTTP |
| Query |
string |
La chaîne de requête vers laquelle rediriger. La chaîne de requête doit comporter de 1 à 128 caractères et peut contenir des lettres minuscules et des caractères visibles. Les caractères #[]{}|<>& ne sont pas pris en charge. |
quert |
| RemoveHeaderConfig |
object |
La configuration de suppression de l'en-tête HTTP. |
|
| Key |
string |
Le nom du champ d'en-tête à supprimer. 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 ne peut pas être utilisé plus d'une fois dans RemoveHeader.
|
key |
| RewriteConfig |
object |
La configuration de la réécriture. |
|
| Host |
string |
L'adresse d'hôte vers laquelle rediriger. Valeurs valides :
|
www.example.com |
| Path |
string |
Le chemin de destination pour la redirection interne. Le chemin doit comporter de 1 à 128 caractères, commencer par une barre oblique (/) et peut contenir des lettres, des chiffres, des astérisques (*), des points d'interrogation (?) et $-_.+/&~@:. Les caractères "%#;!()[]^," ne sont pas pris en charge. |
/tsdf |
| Query |
string |
La chaîne de requête pour la redirection interne. La chaîne de requête doit comporter de 1 à 128 caractères et peut contenir des lettres minuscules et des caractères visibles. Les caractères #[]{}|<>& ne sont pas pris en charge. |
quedsa |
| TrafficMirrorConfig |
object |
La configuration de la mise en miroir du trafic. |
|
| TargetType |
string |
La destination de la mise en miroir du trafic, qui peut être un groupe de serveurs. |
ForwardGroupMirror |
| MirrorGroupConfig |
object |
La configuration pour la mise en miroir du trafic vers un groupe de serveurs. |
|
| ServerGroupTuples |
array<object> |
La configuration pour la mise en miroir du trafic vers un groupe de serveurs. |
|
|
object |
Le groupe de serveurs cible pour la mise en miroir du trafic. |
||
| ServerGroupId |
string |
L'identifiant du groupe de serveurs. |
sgp-00mkgijak0w4qgz9**** |
| Weight |
integer |
Le poids. Valeurs valides : 0 à 100. |
2 |
| TrafficLimitConfig |
object |
La configuration de limitation du trafic. |
|
| QPS |
integer |
Le nombre de requêtes par seconde (QPS). Valeurs valides : 1 à 100000. |
4 |
| PerIpQps |
integer |
Le nombre de requêtes par seconde pour chaque adresse IP. Valeurs valides : 1 à 100000.\n\n> Si vous configurez à la fois les paramètres QPS et PerIpQps, la valeur de PerIpQps doit être inférieure à la valeur de QPS. |
80 |
| Type |
string |
Le type d'action. Valeurs valides :
|
ForwardGroup |
| CorsConfig |
object |
La configuration CORS. |
|
| AllowOrigin |
array |
Les origines autorisées. |
|
|
string |
L'origine autorisée. Vous pouvez définir ce paramètre sur
|
http://test.com |
|
| AllowMethods |
array |
Les méthodes HTTP autorisées pour l'accès cross-origin. |
|
|
string |
La méthode HTTP autorisée pour l'accès inter-origine. Valeurs valides :
|
GET |
|
| AllowHeaders |
array |
Les en-têtes cross-origin autorisés. |
|
|
string |
Les en-têtes cross-origin autorisés. Vous pouvez définir ce paramètre sur |
test_123 |
|
| ExposeHeaders |
array |
Les en-têtes qui peuvent être exposés. |
|
|
string |
Les en-têtes cross-origin autorisés. Vous pouvez définir ce paramètre sur |
test_123 |
|
| AllowCredentials |
string |
Indique si les informations d'identification sont autorisées. Valeurs valides :\n\n- on : les informations d'identification sont autorisées.\n- off : les informations d'identification ne sont pas autorisées. |
on |
| MaxAge |
integer |
La durée maximale de mise en cache pour les requêtes preflight dans le navigateur. Unité : secondes.\n\nValeurs valides : -1 à 172800. |
1000 |
| RuleConditions |
array<object> |
La liste des conditions de la règle de transfert. |
|
|
array<object> |
La structure de condition de la règle de transfert. |
||
| CookieConfig |
object |
La configuration du cookie. |
|
| Values |
array<object> |
Les valeurs du cookie. |
|
|
object |
Les valeurs du cookie. |
||
| Key |
string |
La clé du cookie. La clé doit comporter de 1 à 100 caractères et peut contenir des lettres minuscules, des caractères imprimables, des astérisques (*) et des points d'interrogation (?). La clé ne peut pas contenir d'espaces ni |
test |
| Value |
string |
La valeur du cookie. La valeur doit comporter de 1 à 128 caractères et peut contenir des lettres minuscules, des caractères imprimables, des astérisques (*) et des points d'interrogation (?). La valeur ne peut pas contenir d'espaces ni |
test |
| HeaderConfig |
object |
La configuration du champ d'en-tête. |
|
| Key |
string |
La clé du champ d'en-tête. La clé doit comporter de 1 à 40 caractères et peut contenir les 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 |
Les valeurs du champ d'en-tête. |
|
|
string |
La valeur du champ d'en-tête. La valeur doit comporter de 1 à 128 caractères et peut contenir des caractères imprimables dans la plage ASCII |
5006 |
|
| HostConfig |
object |
La configuration du nom d'hôte. |
|
| Values |
array |
Les noms d'hôte. |
|
|
string |
Le nom d'hôte. Règles de nommage :
|
www.example.com |
|
| MethodConfig |
object |
La configuration de la méthode de requête. |
|
| Values |
array |
Les méthodes de requête. |
|
|
string |
La méthode de requête.\n\nValeurs valides : HEAD, GET, POST, OPTIONS, PUT, PATCH et DELETE. |
PUT |
|
| PathConfig |
object |
La configuration du chemin de transfert. |
|
| Values |
array |
Les chemins de transfert. |
|
|
string |
Le chemin de transfert. Le chemin doit comporter de 1 à 128 caractères, commencer par une barre oblique (/) et peut contenir des lettres, des chiffres, des astérisques (*), des points d'interrogation (?) et |
/test |
|
| QueryStringConfig |
object |
La configuration de la chaîne de requête. |
|
| Values |
array<object> |
Les chaînes de requête. |
|
|
object |
Les chaînes de requête. |
||
| Key |
string |
La clé de la chaîne de requête. La clé doit comporter de 1 à 100 caractères et peut contenir des lettres minuscules, des caractères imprimables, des astérisques (*) et des points d'interrogation (?). La clé ne peut pas contenir d'espaces ni |
test |
| Value |
string |
La valeur de la chaîne de requête. La valeur doit comporter de 1 à 128 caractères et peut contenir des lettres minuscules, des caractères imprimables, des astérisques (*) et des points d'interrogation (?). La valeur ne peut pas contenir d'espaces ni |
test |
| SourceIpConfig |
object |
La configuration de correspondance du trafic de service basée sur l'IP source. |
|
| Values |
array |
Les adresses IP source à faire correspondre. |
|
|
string |
Une ou plusieurs adresses IP ou blocs CIDR.\n\nUn maximum de 5 adresses IP source peuvent être ajoutées à une règle de transfert. |
192.168.XX.XX/32 |
|
| ResponseStatusCodeConfig |
object |
La configuration du code d'état de la réponse. |
|
| Values |
array |
La liste des codes d'état de la réponse. |
|
|
string |
Le code d'état de la réponse. |
200 |
|
| ResponseHeaderConfig |
object |
La configuration de l'en-tête HTTP de réponse. |
|
| Key |
string |
La clé de l'en-tête HTTP de réponse. La clé doit comporter entre 1 et 40 caractères. Elle 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. |
key |
| Values |
array |
La liste des valeurs de l'en-tête HTTP de réponse. |
|
|
string |
La valeur de l'en-tête HTTP de réponse. La valeur doit comporter entre 1 et 128 caractères. |
value |
|
| Type |
string |
Le type de la règle de transfert. Valeurs valides :
|
Host |
| RuleId |
string |
L'identifiant de la règle de transfert. |
rule-bpn0kn908w4nbw**** |
| RuleName |
string |
Le nom de la règle de transfert. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Le nom doit commencer par une lettre. |
rule-instance-test |
| RuleStatus |
string |
L'état de la règle de transfert. Valeurs valides :
|
Available |
| Direction |
string |
La direction de la règle de transfert. Valeurs valides :
Remarque
Les instances ALB Basic Edition ne prennent pas en charge le type Response. |
Request |
| Tags |
array<object> |
Les balises. |
|
|
object |
La structure de balise. |
||
| Key |
string |
La clé de balise. La clé de 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 |
La valeur de balise. La valeur de 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 |
| TotalCount |
integer |
Le nombre total d'enregistrements de données renvoyés pour la requête en cours. |
1000 |
Exemples
JSON format
{
"MaxResults": 50,
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876F******",
"Rules": [
{
"ListenerId": "lsn-i35udpz3pxsmnf****",
"LoadBalancerId": "alb-x30o38azsuj0sx****",
"Priority": 1,
"RuleActions": [
{
"FixedResponseConfig": {
"Content": "dssacav",
"ContentType": "text/plain",
"HttpCode": "HTTP_2xx"
},
"ForwardGroupConfig": {
"ServerGroupTuples": [
{
"ServerGroupId": "sgp-atstuj3rtoptyui****",
"Weight": 2
}
],
"ServerGroupStickySession": {
"Enabled": true,
"Timeout": 100
}
},
"InsertHeaderConfig": {
"Key": "key",
"Value": "ClientSrcPort",
"ValueType": "SystemDefined"
},
"Order": 1,
"RedirectConfig": {
"Host": "www.example.com",
"HttpCode": "301",
"Path": "/test",
"Port": "10",
"Protocol": "HTTP",
"Query": "quert"
},
"RemoveHeaderConfig": {
"Key": "key"
},
"RewriteConfig": {
"Host": "www.example.com",
"Path": "/tsdf",
"Query": "quedsa"
},
"TrafficMirrorConfig": {
"TargetType": "ForwardGroupMirror",
"MirrorGroupConfig": {
"ServerGroupTuples": [
{
"ServerGroupId": "sgp-00mkgijak0w4qgz9****",
"Weight": 2
}
]
}
},
"TrafficLimitConfig": {
"QPS": 4,
"PerIpQps": 80
},
"Type": "ForwardGroup",
"CorsConfig": {
"AllowOrigin": [
"http://test.com"
],
"AllowMethods": [
"GET"
],
"AllowHeaders": [
"test_123"
],
"ExposeHeaders": [
"test_123"
],
"AllowCredentials": "on",
"MaxAge": 1000
}
}
],
"RuleConditions": [
{
"CookieConfig": {
"Values": [
{
"Key": "test",
"Value": "test"
}
]
},
"HeaderConfig": {
"Key": "Port",
"Values": [
"5006"
]
},
"HostConfig": {
"Values": [
"www.example.com"
]
},
"MethodConfig": {
"Values": [
"PUT"
]
},
"PathConfig": {
"Values": [
"/test"
]
},
"QueryStringConfig": {
"Values": [
{
"Key": "test",
"Value": "test"
}
]
},
"SourceIpConfig": {
"Values": [
"192.168.XX.XX/32"
]
},
"ResponseStatusCodeConfig": {
"Values": [
"200"
]
},
"ResponseHeaderConfig": {
"Key": "key",
"Values": [
"valeur"
]
},
"Type": "Host"
}
],
"RuleId": "rule-bpn0kn908w4nbw****",
"RuleName": "rule-instance-test",
"RuleStatus": "Available",
"Direction": "Request",
"Tags": [
{
"Key": "env",
"Value": "product"
}
]
}
],
"TotalCount": 1000
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 403 | Forbidden.LoadBalancer | Authentication is failed for %s. | Échec de l'authentification pour l'opération d'équilibrage de charge. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.