CreateMasterSlaveServerGroup - - Centre de documentation Alibaba Cloud

Crée un groupe de serveurs principal/secondaire. Un groupe de serveurs principal/secondaire ne peut contenir que deux serveurs backend : un serveur principal et un serveur secondaire.

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.

slb:CreateMasterSlaveServerGroup

create

Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}

*LoadBalancer.

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

slb:tag

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'instance Classic Load Balancer (CLB).	cn-hangzhou
LoadBalancerId	string	Oui	L'identifiant de l'instance Classic Load Balancer (CLB).	lb-bp1hv944r69al4j******
MasterSlaveServerGroupName	string	Non	Le nom du groupe de serveurs principal/secondaire.	Group1
MasterSlaveBackendServers	string	Non	La liste des serveurs backend dans le groupe de serveurs principal/secondaire. Un groupe de serveurs principal/secondaire ne peut contenir que deux serveurs backend. Les paramètres suivants sont inclus : ServerId : chaîne de caractères, obligatoire. L'identifiant de l'instance du serveur backend. Les valeurs valides incluent les identifiants d'instance ECS, les identifiants d'instance ENI et les identifiants d'instance ECI. Lorsque la valeur de ServerId est un identifiant d'instance ENI ou un identifiant d'instance ECI, le paramètre Type est obligatoire. Weight : le poids du serveur backend. Valeurs valides : 0 à 100. Valeur par défaut : 100. Si la valeur est 0, aucune requête n'est transférée au serveur backend. Description : chaîne de caractères, facultatif. La description du serveur backend. La description doit comporter entre 1 et 80 caractères et peut contenir des lettres, des chiffres, des traits d'union (-), des barres obliques (/), des points (.) et des traits de soulignement (_). Les caractères chinois sont pris en charge. Type : le type de serveur du serveur backend. Valeurs valides : ecs : instance ECS (par défaut). eni : instance de contrôleur d'interface réseau élastique (NIC). eci : instance de conteneur élastique. Remarque Seules les instances à performances garanties prennent en charge l'ajout de serveurs backend de type eni et eci. ServerIp : l'adresse IP de l'instance ENI ou ECI. Port : le port backend utilisé pour accepter les requêtes. ServerType : chaîne de caractères. Le type principal ou secondaire du serveur backend. Valeurs valides : Master : serveur principal. Slave : serveur secondaire.	[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"82","ServerType":"Master","Description":"test-112" }, { "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"84","ServerType":"Slave","Description":"test-112" }]
Tag	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de balise de la ressource. Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide si elle est spécifiée. La clé de balise peut comporter jusqu'à 64 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	test
Value	string	Non	La valeur de balise de la ressource. Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide si elle est spécifiée. 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://`.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
MasterSlaveServerGroupId	string	L'identifiant du groupe de serveurs principal/secondaire.	rsp-bp19au4******
RequestId	string	L'identifiant de la requête.	7CA4DB76-4D32-523B-822E-5C9******
MasterSlaveBackendServers	object
MasterSlaveBackendServer	array<object>	La liste des serveurs backend dans le groupe de serveurs principal/secondaire.
	object	La liste des serveurs backend dans le groupe de serveurs principal/secondaire.
Type	string	Le type de serveur du serveur backend. Valeurs valides : ecs : instance ECS. eni : instance de contrôleur d'interface réseau élastique (NIC). eci : instance de conteneur élastique.	ecs
Weight	integer	Le poids du serveur backend.	100
Description	string	La description du groupe de serveurs principal/secondaire.	test-112
Port	integer	Le port utilisé par le serveur backend.	82
ServerId	string	L'identifiant de l'instance du serveur backend à ajouter.	i-bp1fq61enf4loa5i****
ServerType	string	Le type de serveur. Valeurs valides : Master ou Slave.	Master

Exemples

JSON format

{
  "MasterSlaveServerGroupId": "rsp-bp19au4******",
  "RequestId": "7CA4DB76-4D32-523B-822E-5C9******",
  "MasterSlaveBackendServers": {
    "MasterSlaveBackendServer": [
      {
        "Type": "ecs",
        "Weight": 100,
        "Description": "test-112",
        "Port": 82,
        "ServerId": "i-bp1fq61enf4loa5i****",
        "ServerType": "Master"
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	BACKEND_SERVERS_NUM_MUST_BE_TWO	Backend servers num must be 2.	Le nombre de serveurs backend doit être de 2.
400	Mismatched.ZoneId	The zone of the server is not matched with the cloud box loadbalancer.	Le zoneId spécifié ne correspond pas.
400	BACKEND_SERVERS_HAVE_SAME_PORT_AND_SERVERID	Backend servers have same port and serverId.	Un serveur virtuel avec le même port et le même identifiant de serveur existe déjà dans le groupe de serveurs backend.
400	BACKEND_SERVERS_CAN_ONLY_CONTAIN_ONE_MASTER_AND_ONE_SLAVE	Backend servers can only contain one master and one slave.	Un groupe de serveurs virtuels principal/secondaire ne peut contenir qu'un seul serveur principal et un seul serveur secondaire.
400	BACKEND_SERVER_ID_CAN_NOT_EMPTY	Backend server id can not empty.	L'identifiant du serveur backend ne peut pas être vide.
400	INVALID_SERVER_TYPE	Invalid server type.
400	BACKEND_SERVER_PORT_CAN_NOT_EMPTY	Backend server port can not empty.	Le port du serveur backend ne peut pas être vide.
400	RealServerPortNotSupport	Real server port not support.	Le port du serveur backend n'est pas pris en charge.
400	OperationUnsupported.CreateMasterSlaveServerGroup	This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.	Ce type de serveur back-end ne peut pas être attaché à une instance SLB SingleTunnel ou AnyTunnel.
400	IncorrectStatus.RSByPassToas	%s.	La configuration BypassToa du serveur backend spécifié n'est pas valide.
400	OperationFailed.ActionNotSupport	The loadbalancer does not support such action.	L'opération a échoué car les instances SLB IPv6 ne prennent pas en charge cette opération.
400	RsTunnelIp2VmNameConflict	%s.
400	NetworkConflict	%s.	Un conflit réseau existe dans les paramètres spécifiés. Vérifiez que les paramètres sont corrects et réessayez.
400	InvalidParam.TagValue	%s.
400	InvalidParam.TagKey	%s.
400	SizeLimitExceeded.Tag	%s.
400	MissingParam.TagKey	The param MissingParam.TagKey is missing.

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

Notes de version

Consultez Notes de version pour la liste complète.