AddUsersToGroup - : Central de Documentação do Alibaba Cloud

Observações de uso

Use esta operação para adicionar um ou mais usuários a um grupo de usuários. Após chamar a operação CreateUserGroup para criar o grupo, chame a operação AddUsersToGroup para incluir vários usuários nesse grupo. Assim, você gerencia e concede permissões aos usuários em lote.

Limite de QPS

O limite desta operação é de 10 chamadas por segundo por conta. Se a frequência de chamadas ultrapassar esse valor, o sistema aplicará throttling, o que pode afetar seus negócios. Considere esse limite ao chamar esta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AddUsersToGroup	A operação a ser executada. Defina o valor como AddUsersToGroup.
InstanceId	String	Sim	bastionhost-cn-st220aw****	ID do bastion host ao qual você deseja adicionar usuários no grupo. Nota Chame a operação DescribeInstances para consultar o ID do bastion host.
UserGroupId	String	Sim	1	ID do grupo de usuários ao qual você deseja adicionar usuários. Nota Chame a operação ListUserGroups para consultar o ID do grupo de usuários.
UserIds	String	Sim	["1","2","3"]	IDs dos usuários a serem adicionados ao grupo. O valor é uma string JSON. É possível adicionar até 100 IDs de usuário. Para especificar vários IDs, separe-os com vírgulas (,). Nota Chame a operação ListUsers para consultar os IDs dos usuários.
RegionId	String	Não	cn-hangzhou	ID da região do bastion host ao qual você deseja adicionar usuários no grupo. Nota Para obter mais informações sobre o mapeamento entre IDs e nomes de regiões, consulte Regiões e zonas.

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

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

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	ID da solicitação, usado para localizar e solucionar problemas.
Results	Array of Item		Resultado da chamada.
Code	String	OK	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 da solicitação é inválido. Nota Verifique se os parâmetros da solicitação são válidos e chame a operação novamente. OBJECT_NOT_FOUND: O objeto especificado para a operação não existe. Nota Verifique se o ID do bastion host especificado existe, se os hosts especificados existem e se os IDs de host são válidos. Em seguida, chame a operação novamente. OBJECT_AlREADY_EXISTS: O objeto especificado para a operação já existe.
Message	String	None	Este parâmetro está obsoleto.
UserGroupId	String	1	ID do grupo.
UserId	String	1	ID do usuário.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AddUsersToGroup
&InstanceId=bastionhost-cn-st220aw****
&UserGroupId=1
&UserIds= ["1","2","3"]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<AddUsersToGroupResponse>
      <RequestId>EC9BF0F4-8983-491A-BC8C-1B4DD94976DE</RequestId>
      <Results>
            <Message></Message>
            <Code>OK</Code>
            <UserId>1</UserId>
            <UserGroupId>1</UserGroupId>
      </Results>
</AddUsersToGroupResponse>

Formato JSON

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError	An unknown error occurred.	Mensagem de erro retornada devido à ocorrência de um erro desconhecido.
400	InvalidParameter	The argument is invalid.	Mensagem de erro retornada porque um ou mais parâmetros são inválidos.

Para obter uma lista de códigos de erro, visite o API Error Center.