AttachHostGroupAccountsToUserGroup - - Centre de documentation Alibaba Cloud

Autorise un utilisateur à gérer un ou plusieurs groupes d'hôtes et comptes d'hôte.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Oui	L'identifiant de l'hôte bastion pour lequel vous souhaitez autoriser le groupe d'utilisateurs à gérer les groupes d'hôtes et comptes d'hôte spécifiés. Remarque Vous pouvez appeler l'opération DescribeInstances pour obtenir l'identifiant de l'hôte bastion.	bastionhost-cn-st220aw****
RegionId	string	Non	L'identifiant de la région de l'hôte bastion pour lequel vous souhaitez autoriser le groupe d'utilisateurs à gérer les groupes d'hôtes et comptes d'hôte spécifiés. Remarque Pour plus d'informations sur le mappage entre les identifiants de région et les noms de région, consultez la section Régions et zones.	cn-hangzhou
UserGroupId	string	Oui	L'identifiant du groupe d'utilisateurs que vous souhaitez autoriser à gérer les groupes d'hôtes et comptes d'hôte spécifiés. Remarque Vous pouvez appeler l'opération ListUserGroups pour obtenir l'identifiant du groupe d'utilisateurs.	1
HostGroups	string	Oui	L'identifiant du groupe d'hôtes et le nom du compte d'hôte que vous souhaitez autoriser le groupe d'utilisateurs à gérer. Vous pouvez spécifier jusqu'à 10 identifiants de groupe d'hôtes et jusqu'à 10 noms de comptes d'hôte pour chaque groupe d'hôtes. Vous pouvez spécifier uniquement des identifiants de groupe d'hôtes. Dans ce cas, le groupe d'utilisateurs est autorisé à gérer uniquement les groupes d'hôtes spécifiés. Pour plus d'informations sur ce paramètre, consultez la section « Description du paramètre HostGroups » de cette rubrique. Remarque Vous pouvez appeler l'opération ListHostGroups pour obtenir l'identifiant du groupe d'hôtes et l'opération ListHostAccounts pour obtenir le nom du compte d'hôte.	[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"4","HostAccountNames":["root","111","abc"]}]

Description de HostGroups.

Champ	Type	Exemple	Description
HostGroupId	string	1	L'identifiant du groupe d'hôtes.
HostAccountNames	array[string]	["root","111","abc"]	Le nom du compte d'hôte. La valeur est une chaîne JSON. Vous pouvez spécifier jusqu'à 10 noms de comptes d'hôte pour chaque groupe d'hôtes.

Le code suivant fournit un exemple de configuration de HostGroups :

[
{"HostGroupId":"1"}, 
{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, 
{"HostGroupId":"3","HostAccountNames":["root","111","abc"]},  
{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} 
]

Toutes les opérations d'API Alibaba Cloud doivent inclure des paramètres de requête communs. Pour plus d'informations sur les paramètres de requête communs, consultez la section Paramètres communs. Pour plus d'informations sur les exemples de requêtes, consultez la section « Exemples » de cette rubrique.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
Results	array<object>	Le résultat de l'appel.
	array<object>
Code	string	Le code de retour qui indique si l'appel a réussi. Valeurs valides : OK : l'appel a réussi. UNEXPECTED : une erreur inconnue s'est produite. INVALID_ARGUMENT : un paramètre de requête n'est pas valide. OBJECT_NOT_FOUND : l'objet spécifié sur lequel vous souhaitez effectuer l'opération n'existe pas. OBJECT_AlREADY_EXISTS : l'objet spécifié sur lequel vous souhaitez effectuer l'opération existe déjà.	OK
Message	string	Ce paramètre est obsolète.	None
HostGroupId	string	L'identifiant du groupe d'hôtes.	1
UserGroupId	string	L'identifiant du groupe d'utilisateurs.	1
HostAccountNames	array<object>	Le résultat de l'autorisation du groupe d'utilisateurs à gérer les comptes d'hôte spécifiés.
	object
Code	string	The return code that indicates whether the user group was authorized to manage the specified host account. Valid values: OK: The call was successful. UNEXPECTED: An unknown error occurred. INVALID_ARGUMENT: A request parameter is invalid. OBJECT_NOT_FOUND: The specified object on which you want to perform the operation does not exist. OBJECT_AlREADY_EXISTS: The specified object on which you want to perform the operation already exists.	OK
Message	string	This parameter is deprecated.	None
HostAccountName	string	The name of the host account.	abc

Exemples

JSON format

{
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "Results": [
    {
      "Code": "OK",
      "Message": "None",
      "HostGroupId": "1",
      "UserGroupId": "1",
      "HostAccountNames": [
        {
          "Code": "OK",
          "Message": "None",
          "HostAccountName": "abc"
        }
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	The argument is invalid.	The argument is invalid.
500	InternalError	An unknown error occurred.	An unknown error occurred.

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

Notes de version

Consultez Notes de version pour la liste complète.