Todos os produtos
Search

Este produto

    Bastionhost:DetachHostGroupAccountsFromUserGroup

    Central de documentação

    Bastionhost:DetachHostGroupAccountsFromUserGroup

    Última atualização: Jun 28, 2026

    Revoga permissões em um ou mais grupos de hosts e contas de host de um grupo de usuários.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    InstanceId

    string

    Sim

    O ID do bastion host para o qual você deseja revogar permissões nos grupos de hosts e contas de host especificados do grupo de usuários.

    Nota

    Você pode chamar a operação DescribeInstances para consultar o ID do bastion host.

    bastionhost-cn-st220aw****
    RegionId

    string

    Não

    O ID da região do bastion host para o qual você deseja revogar permissões nos grupos de hosts e contas de host especificados do grupo de usuários.

    Nota

    Para mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas.

    cn-hangzhou
    UserGroupId

    string

    Sim

    O ID do grupo de usuários do qual você deseja revogar permissões nos grupos de hosts e contas de host especificados.

    Nota

    Você pode chamar a operação ListUserGroups para consultar o ID do grupo de usuários.

    1
    HostGroups

    string

    Sim

    O ID do grupo de hosts e o nome da conta de host nos quais você deseja revogar permissões do grupo de usuários. Você pode especificar até 10 IDs de grupo de hosts e até 10 nomes de conta de host para cada grupo de hosts. Você pode especificar apenas IDs de grupo de hosts. Nesse caso, as permissões nos grupos de hosts especificados e em todas as contas de host nos grupos de hosts são revogadas do grupo de usuários. Para mais informações sobre este parâmetro, consulte a seção "Descrição do parâmetro HostGroups" deste tópico.

    Nota

    Você pode chamar a operação ListHostGroups para consultar o ID do grupo de hosts e a operação ListHostAccounts para consultar o nome da conta de host.

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

    Descrição do parâmetro HostGroups.

    CampoTipoExemploDescrição
    HostGroupIdstring1O ID do grupo de hosts.
    HostAccountNamesarray[string]["root","111","abc"]O nome da conta de host. O valor é uma string JSON. Você pode especificar até 10 nomes de conta de host para cada grupo de hosts.
    O código a seguir fornece um exemplo das configurações do parâmetro HostGroups:
    [
{"HostGroupId":"1"}, 
{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, 
{"HostGroupId":"3","HostAccountNames":["root","111","abc"]},  
{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} 
]

    Todas as operações de API da Alibaba Cloud devem incluir parâmetros de solicitação comuns. Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

    Para mais informações sobre exemplos de solicitações, consulte a seção "Exemplos" deste tópico.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
    Results

    array<object>

    O resultado da chamada.

    array<object>

    Code

    string

    O código de retorno que indica se a chamada foi bem-sucedida. Valores válidos:

    • OK: A chamada foi bem-sucedida.

    • UNEXPECTED: Ocorreu um erro desconhecido.

    • INVALID_ARGUMENT: Um parâmetro de solicitação é inválido.

    • OBJECT_NOT_FOUND: O objeto especificado no qual você deseja realizar a operação não existe.

    • OBJECT_AlREADY_EXISTS: O objeto especificado no qual você deseja realizar a operação já existe.

    OK
    Message

    string

    Este parâmetro está obsoleto.

    None
    HostGroupId

    string

    O ID do grupo de hosts.

    1
    UserGroupId

    string

    O ID do grupo de usuários.

    1
    HostAccountNames

    array<object>

    O resultado da revogação de permissões nas contas de host especificadas do grupo de usuários.

    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

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidParameter The argument is invalid. The argument is invalid.
    500 InternalError An unknown error occurred. An unknown error occurred.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.