Cria um grupo de usuários para um bastion host.
Descrição da operação
Cria um grupo de usuários para um bastion host como administrador. Após criar o grupo, use a operação AddUsersToGroup para adicionar vários usuários de uma vez, permitindo a autorização e o gerenciamento centralizados de usuários.
Você pode chamar esta operação até 10 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, a limitação de taxa será acionada. Como resultado, seu negócio pode ser afetado. Recomendamos que você observe o limite ao chamar esta operação.
Experimente agora
Testar
Autorização RAM
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 criar um 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 criar um grupo de usuários. 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 |
| UserGroupName |
string |
Sim |
O nome do grupo de usuários que você deseja criar. Este nome pode ter até 128 caracteres. |
group |
| Comment |
string |
Não |
A descrição do grupo de usuários. A descrição pode ter até 500 caracteres. |
comment |
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 exemplos de solicitações, consulte a seção "Exemplos" deste tópico.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os dados retornados. |
||
| UserGroupId |
string |
O ID do grupo de usuários. |
1 |
| RequestId |
string |
O ID da solicitação, que é usado para localizar e solucionar problemas. |
EC9BF0F4-8983-491A-BC8C-1B4DD94976DE |
Exemplos
Resposta de sucesso
JSON formato
{
"UserGroupId": "1",
"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE"
}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. |
| 400 | UserGroupAlreadyExists | The user group already exists. | The user group already exists. |
| 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.