DetachHostAccountsFromUser - - Centre de documentation Alibaba Cloud

Révoque les autorisations d'un utilisateur sur les hôtes et les 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 sur lequel vous souhaitez révoquer les autorisations de l'utilisateur sur les 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 sur lequel vous souhaitez révoquer les autorisations de l'utilisateur sur les 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
UserId	string	Oui	L'identifiant de l'utilisateur pour lequel vous souhaitez révoquer les autorisations sur les hôtes et comptes d'hôte spécifiés. Remarque Vous pouvez appeler l'opération ListUsers pour obtenir l'identifiant de l'utilisateur.	1
Hosts	string	Oui	Les identifiants des hôtes et des comptes d'hôte sur lesquels vous souhaitez révoquer les autorisations de l'utilisateur. Vous pouvez spécifier jusqu'à 10 identifiants d'hôte et jusqu'à 10 identifiants de compte d'hôte pour chaque hôte. Vous pouvez spécifier uniquement des identifiants d'hôte. Dans ce cas, les autorisations sur les hôtes spécifiés et tous les comptes de ces hôtes sont révoquées pour l'utilisateur. Pour plus d'informations sur ce paramètre, consultez la section Description du paramètre Hosts de cette rubrique. Remarque Vous pouvez appeler l'opération ListHosts pour obtenir les identifiants d'hôte et l'opération ListHostAccountsForUser pour obtenir les identifiants de compte d'hôte.	[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3"]}, {"HostId":"3","HostAccountIds":["4","5","6"]}, {"HostId":"4","HostAccountIds":["9","8","7"]} ]

Description du paramètre Hosts.

Champ	Type	Exemple	Description
HostId	string	1	L'identifiant de l'hôte.
HostAccountIds	array[string]	["9","8","7"]	L'identifiant du compte d'hôte. La valeur est une chaîne JSON. Vous pouvez spécifier jusqu'à 10 identifiants de compte d'hôte pour chaque hôte.

Le code suivant fournit un exemple de valeur pour le paramètre Hosts :

[
{"HostId":"1"},
{"HostId":"2","HostAccountIds":["1","2","3",...]},
{"HostId":"3","HostAccountIds":["4","5","6",...]},
{"HostId":"4","HostAccountIds":["9","8","7",...]}
]

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 de requête communs. Pour plus d'informations sur les exemples de requêtes, consultez la section Exemples de requêtes.

É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
HostId	string	L'identifiant de l'hôte.	1
UserId	string	L'identifiant de l'utilisateur.	1
HostAccounts	array<object>	Le résultat de la révocation des autorisations de l'utilisateur sur les comptes d'hôte spécifiés.
	object
Code	string	The return code that indicates whether permissions on the specified host accounts 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
HostAccountId	string	The host account ID.	1

Exemples

JSON format

{
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "Results": [
    {
      "Code": "OK",
      "Message": "None",
      "HostId": "1",
      "UserId": "1",
      "HostAccounts": [
        {
          "Code": "OK",
          "Message": "None",
          "HostAccountId": "1"
        }
      ]
    }
  ]
}

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.