LoadBalancerJoinSecurityGroup - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Assurez-vous d'avoir créé un groupe de sécurité. Pour plus d'informations, consultez la rubrique CreateSecurityGroup.
Une instance NLB peut être associée à quatre groupes de sécurité au maximum.
Pour interroger les groupes de sécurité associés à une instance NLB, appelez l'opération GetLoadBalancerAttribute.
L'opération LoadBalancerJoinSecurityGroup est asynchrone. Le système renvoie un ID de requête et exécute la tâche en arrière-plan. Pour connaître l'état de la tâche, appelez l'opération GetJobStatus.
- Si la tâche est dans l'état Succeeded, le groupe de sécurité est associé.
- Si la tâche est dans l'état Processing, l'association du groupe de sécurité est en cours. Seules les opérations de lecture sont alors autorisées.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	LoadBalancerJoinSecurityGroup	Nom de l'opération à effectuer. Définissez la valeur sur LoadBalancerJoinSecurityGroup.
SecurityGroupIds.N	String	No	sg-bp1fg655nh68xyz9****	ID du groupe de sécurité.
LoadBalancerId	String	Yes	nlb-83ckzc8d4xlp8o****	ID de l'instance NLB à associer au groupe de sécurité.
DryRun	Boolean	No	true	Indique s'il faut vérifier la requête sans l'exécuter. Valeurs possibles : true : vérifie la requête sans l'exécuter. Le système vérifie les paramètres obligatoires, la syntaxe et les limites. En cas d'échec, un code d'erreur est renvoyé. En cas de succès, le code d'erreur `DryRunOperation` est renvoyé. false (valeur par défaut) : envoie la requête. Si la vérification réussit, un code d'état HTTP 2xx est renvoyé et l'opération est exécutée.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez générer cette valeur via le client, mais elle doit être unique pour chaque requête. Le jeton client ne peut contenir que des caractères ASCII. Remarque Si ce paramètre n'est pas défini, le système utilise automatiquement la valeur de RequestId comme valeur de ClientToken. La valeur de RequestId peut varier pour chaque requête API.
RegionId	String	No	cn-hangzhou	ID de la région où l'instance NLB est déployée. Appelez l'opération DescribeRegions pour obtenir la liste des régions.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	CEF72CEB-54B6-4AE8-B225-F876FF7BA984	ID de la requête.
JobId	String	72dcd26b-f12d-4c27-b3af-18f6aed5****	ID de la tâche asynchrone.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=LoadBalancerJoinSecurityGroup
&SecurityGroupIds=["sg-bp1fg655nh68xyz9****"]
&LoadBalancerId=nlb-83ckzc8d4xlp8o****
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&Common request parameters

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<LoadBalancerJoinSecurityGroupResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</LoadBalancerJoinSecurityGroupResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.