DetachHostGroupAccountsFromUserGroup - - Centre de documentation Alibaba Cloud

Révoque les autorisations d'un groupe d'utilisateurs sur 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 révoquer les autorisations du groupe d'utilisateurs sur 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 révoquer les autorisations du groupe d'utilisateurs sur 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 pour lequel vous souhaitez révoquer les autorisations sur 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 pour lesquels vous souhaitez révoquer les autorisations du groupe d'utilisateurs. Vous pouvez spécifier jusqu'à 10 identifiants de groupe d'hôtes et jusqu'à 10 noms de compte d'hôte pour chaque groupe d'hôtes. Vous pouvez spécifier uniquement des identifiants de groupe d'hôtes. Dans ce cas, les autorisations sur les groupes d'hôtes spécifiés et tous les comptes d'hôte de ces groupes sont révoquées pour le groupe d'utilisateurs. 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 du paramètre 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 compte d'hôte pour chaque groupe d'hôtes.
Le code suivant fournit un exemple de configuration du paramètre 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 la 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.	1
HostAccountNames	array<object>	Le résultat de la révocation des autorisations sur les comptes d'hôte spécifiés pour le groupe d'utilisateurs.
	object
Code	string	The return code that indicates whether permissions on the specified host account were revoked from the specified user group. 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.	root

Exemples

JSON format

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

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.