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

Observações de uso

Esta operação permite que o administrador crie um grupo de usuários em um bastion host. Em seguida, utilize a operação AddUsersToGroup para adicionar vários usuários ao grupo simultaneamente. Após a inclusão dos usuários, é possível autorizar e gerenciar o acesso de forma centralizada.

Limites

O limite desta operação é de 10 chamadas por segundo por conta. Caso a frequência de chamadas ultrapasse esse valor, o sistema aplica limitação de taxa (throttling), o que pode impactar seus serviços. Recomendamos considerar esse limite ao invocar esta API.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateUserGroup	A operação que você deseja executar. Defina o valor como CreateUserGroup.
InstanceId	String	Yes	bastionhost-cn-st220aw****	O ID do bastion host no qual você deseja criar o grupo de usuários. Nota Utilize a operação DescribeInstances para consultar o ID do bastion host.
UserGroupName	String	Yes	group	Nome do novo grupo de usuários. O tamanho máximo permitido é de 128 caracteres.
RegionId	String	No	cn-hangzhou	ID da região do bastion host onde o grupo de usuários será criado. Nota Para obter mais informações sobre o mapeamento entre IDs e nomes de regiões, consulte Regiões e zonas.
Comment	String	No	comment	Observações sobre o grupo de usuários. Este campo aceita até 500 caracteres.

Todas as operações da API do Alibaba Cloud exigem parâmetros de solicitação comuns. Para mais detalhes sobre esses parâmetros, consulte Parâmetros comuns.

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

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	ID da solicitação, utilizado para localizar e solucionar problemas.
UserGroupId	String	1	ID do grupo de usuários criado.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateUserGroup
&InstanceId=bastionhost-cn-st220aw****
&UserGroupName=group
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<CreateUserGroupResponse>
      <RequestId>EC9BF0F4-8983-491A-BC8C-1B4DD94976DE</RequestId>
      <UserGroupId>1</UserGroupId>
</CreateUserGroupResponse>

Formato JSON

{
	"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
	"UserGroupId": "1"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
500	InternalError	An unknown error occurred.	Mensagem retornada quando ocorre um erro desconhecido.
400	InvalidParameter	The argument is invalid.	Indica que um ou mais parâmetros fornecidos são inválidos.
400	UserGroupAlreadyExists	The user group already exists.	O grupo de usuários que você tenta criar já existe no sistema.

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