ListHostGroupsForUser - Bastionhost: Central de Documentação do Alibaba Cloud

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 cujo usuário você deseja consultar. 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 cujo usuário você deseja consultar. Nota Para obter mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas.	cn-hangzhou
Mode	string	Não	A categoria dos grupos de hosts a serem consultados. Valores válidos: Authorized (padrão): consulta os grupos de hosts que o usuário está autorizado a gerenciar. Unauthorized: consulta os grupos de hosts que o usuário não está autorizado a gerenciar.	Authorized
UserId	string	Sim	O ID do usuário. Nota Você pode chamar a operação ListUsers para consultar o ID do usuário.	１
PageNumber	string	Não	O número da página. Valor padrão: 1.	１
PageSize	string	Não	O número de entradas por página. Valores válidos: 1 a 100. Valor padrão: 20. Se você deixar este parâmetro vazio, 20 entradas serão retornadas em cada página. Nota Recomendamos que você não deixe este parâmetro vazio.	20
HostGroupName	string	Não	O nome do grupo de hosts a ser consultado. O nome pode ter até 128 caracteres. Somente correspondência exata é suportada.	group

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número total de grupos de hosts retornados.	1
RequestId	string	O ID da solicitação.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
HostGroups	array<object>	Os grupos de hosts retornados.
	object
HostGroupId	string	O ID do grupo de hosts.	１
Comment	string	As observações do grupo de hosts.	comment
HostGroupName	string	O nome do grupo de hosts.	group

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "HostGroups": [
    {
      "HostGroupId": "１",
      "Comment": "comment",
      "HostGroupName": "group"
    }
  ]
}

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.