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

Autoriza um grupo de usuários a gerenciar um ou mais hosts e contas de host.

Descrição da operação

Após autorizar um grupo de usuários a gerenciar hosts e contas de host específicos, todos os usuários do grupo de usuários terão acesso aos hosts e contas de host autorizados.

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 no qual você deseja autorizar o grupo de usuários a gerenciar os hosts e as contas de host especificados. 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 no qual você deseja autorizar o grupo de usuários a gerenciar os hosts e as contas de host especificados. 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
UserGroupId	string	Sim	O ID do grupo de usuários que você deseja autorizar a gerenciar os hosts e as contas de host especificados. Nota Você pode chamar a operação ListUserGroups para consultar o ID do grupo de usuários.	1
Hosts	string	Sim	Os IDs do host e da conta de host que você deseja autorizar o grupo de usuários a gerenciar. Você pode especificar até 10 IDs de host e até 10 IDs de conta de host para cada host. Você pode especificar apenas IDs de host. Nesse caso, o grupo de usuários é autorizado a gerenciar apenas os hosts especificados. Para obter mais informações sobre este parâmetro, consulte a seção "Descrição do parâmetro Hosts" deste tópico. Nota Você pode chamar a operação ListHosts para consultar o ID do host e a operação ListHostAccounts para consultar o ID da conta de host.	[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3",...]}, {"HostId":"3","HostAccountIds":["4","5","6",...]}, {"HostId":"4","HostAccountIds":["9","8","7",...]} ... ]

Descrição do parâmetro Hosts.

Campo	Tipo	Exemplo	Descrição
HostId	string	1	O ID do host.
HostAccountIds	array[string]	["9","8","7"]	O ID da conta de host. O valor é uma string JSON. Você pode especificar até 10 IDs de conta de host para cada host.

O código a seguir fornece um exemplo das configurações do parâmetro Hosts:

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

Todas as solicitaçõ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 comuns. Para obter mais informações sobre solicitações de exemplo, 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 executar a operação não existe. OBJECT_AlREADY_EXISTS: O objeto especificado no qual você deseja executar a operação já existe.	OK
Message	string	Este parâmetro foi descontinuado.	None
HostId	string	O ID do host.	1
UserGroupId	string	O ID do grupo de usuários.	1
HostAccounts	array<object>	O resultado da autorização do grupo de usuários especificado para gerenciar as contas de host especificadas.
	object
Code	string	The return code that indicates whether the user group was authorized to manage the specified host account. 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 ID of the host account.	1

Exemplos

Resposta de sucesso

JSON formato

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

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.