Tous les produits
Search

Ce produit

    :DetachHostAccountsFromUserGroup

    Centre de documentation

    :DetachHostAccountsFromUserGroup

    Dernière mise à jour :Sep 20, 2026

    Supprime les hôtes et les comptes d'hôte autorisés d'un groupe d'utilisateurs.

    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.

    yundun-bastionhost:DetachHostAccountsFromUserGroup

    update

    *Instance.

    acs:yundun-bastionhost:{#regionId}:{#accountId}:instance/{#InstanceId}

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    InstanceId

    string

    Oui

    L'identifiant de l'instance Bastionhost dans laquelle se trouve le groupe d'utilisateurs dont vous souhaitez supprimer les autorisations des hôtes et des comptes d'hôte.

    Remarque

    Vous pouvez appeler l'opération DescribeInstances pour obtenir ce paramètre.

    bastionhost-cn-st220aw****
    RegionId

    string

    Non

    L'identifiant de la région de l'instance Bastionhost dans laquelle se trouve le groupe d'utilisateurs dont vous souhaitez supprimer les hôtes et les comptes d'hôte autorisés.

    Remarque

    Pour la correspondance entre les identifiants de région et les noms de région, consultez Régions et zones.

    cn-hangzhou
    UserGroupId

    string

    Oui

    L'identifiant du groupe d'utilisateurs dont vous souhaitez supprimer les hôtes et les comptes d'hôte autorisés.

    Remarque

    Vous pouvez appeler l'opération ListUserGroups pour obtenir ce paramètre.

    １
    Hosts

    string

    Oui

    Les identifiants des hôtes et les identifiants des comptes d'hôte que vous souhaitez supprimer du groupe d'utilisateurs.
    Vous pouvez spécifier jusqu'à 10 identifiants d'hôte, et chaque hôte prend en charge jusqu'à 10 identifiants de compte d'hôte. Vous n'avez pas besoin de spécifier les identifiants de compte d'hôte. Si vous ne spécifiez pas d'identifiants de compte d'hôte, l'hôte autorisé et tous ses comptes d'hôte autorisés sont supprimés du groupe d'utilisateurs. Pour connaître la structure spécifique de ce paramètre, consultez la description de la structure du paramètre Hosts sous la liste des paramètres de requête.

    Remarque

    Vous pouvez appeler l'opération ListHosts pour obtenir les identifiants des hôtes et l'opération ListHostAccounts pour obtenir les identifiants des comptes d'hôte.

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

    integer

    Non

    L'identifiant du projet.

    3

    Description de la structure du paramètre Hosts

    ChampTypeExempleDescription
    HostIdstring1L'identifiant de l'hôte.
    HostAccountIdsarray[string]["9","8","7"]Les identifiants des comptes d'hôte. Ce paramètre est une chaîne au format JSON. Vous pouvez spécifier jusqu'à 10 identifiants de compte d'hôte.

    Voici un exemple de ce paramètre.

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

    É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>

    Les résultats de l'appel de l'opération.

    array<object>

    Code

    string

    Le code de résultat de l'opération. Valeurs valides :

    • OK : L'opération a réussi.

    • UNEXPECTED : Une erreur inconnue s'est produite.

    • INVALID_ARGUMENT : Les paramètres de la requête ne sont pas valides.

    • OBJECT_NOT_FOUND : L'objet spécifié n'existe pas.

    • OBJECT_AlREADY_EXISTS : L'objet spécifié existe déjà.

    OK
    Message

    string

    Ce paramètre est obsolète et peut être ignoré.

    None
    HostId

    string

    L'identifiant de l'hôte.

    １
    UserGroupId

    string

    L'identifiant du groupe d'utilisateurs.

    １
    HostAccounts

    array<object>

    Les résultats de la suppression des comptes d'hôte autorisés du groupe d'utilisateurs.

    object

    Code

    string

    Le code de résultat de la suppression du compte d'hôte autorisé du groupe d'utilisateurs. Valeurs valides :

    • OK : L'opération a réussi.

    • UNEXPECTED : Une erreur inconnue s'est produite.

    • INVALID_ARGUMENT : Les paramètres de la requête ne sont pas valides.

    • OBJECT_NOT_FOUND : L'objet spécifié n'existe pas.

    • OBJECT_AlREADY_EXISTS : L'objet spécifié existe déjà.

    OK
    Message

    string

    Ce paramètre est obsolète et peut être ignoré.

    None
    HostAccountId

    string

    L'identifiant du compte d'hôte.

    １

    Exemples

    JSON format

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

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 InvalidParameter The argument is invalid.
    500 InternalError 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.