DetachHostGroupAccountsFromUser - - Centre de documentation Alibaba Cloud

Supprime les groupes d'hôtes et les comptes d'hôtes de la liste des groupes d'hôtes et des comptes d'hôtes qu'un utilisateur est autorisé à gérer.

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 de l'utilisateur sur les groupes d'hôtes et les comptes d'hôtes 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 de l'utilisateur sur les groupes d'hôtes et les comptes d'hôtes spécifiés. Remarque Pour plus d'informations sur le mappage entre les identifiants de région et les noms de région, consultez Régions et zones.	cn-hangzhou
UserId	string	Oui	L'identifiant de l'utilisateur pour lequel vous souhaitez révoquer les autorisations sur les groupes d'hôtes et les comptes d'hôtes spécifiés. Remarque Vous pouvez appeler l'opération ListUsers pour obtenir l'identifiant de l'utilisateur.	1
HostGroups	string	Oui	L'identifiant du groupe d'hôtes et le nom du compte d'hôtes pour lesquels vous souhaitez révoquer les autorisations de l'utilisateur. Vous pouvez spécifier jusqu'à 10 identifiants de groupe d'hôtes et jusqu'à 10 noms de compte d'hôtes 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ôtes de ces groupes sont révoquées pour l'utilisateur. 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ôtes.	[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}]

Structure du paramètre HostGroups.

Paramètre	Type	Exemple	Description
HostGroupId	string	1	L'identifiant du groupe d'hôtes.
HostAccountNames	array[string]	["root","111","abc"]	Les noms des comptes d'hôtes. Spécifiez une chaîne JSON. Vous pouvez spécifier jusqu'à 10 noms de compte d'hôtes.

Le code suivant fournit un exemple :

[
{"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 Paramètres communs. Pour plus d'informations sur les exemples de requêtes, consultez la section Exemples de requêtes 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
UserId	string	L'identifiant de l'utilisateur.	1
HostAccountNames	array<object>	Le résultat de la révocation des autorisations de l'utilisateur sur les comptes d'hôtes spécifiés.
	object
Code	string	The return code that indicates whether permissions on the specified host account were revoked from the user. 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",
      "UserId": "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.