

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criação e gerenciamento de grupos no Amazon Quick
<a name="creating-quicksight-groups"></a>


|  | 
| --- |
|    Público-alvo: administradores de sistemas  | 


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 

**nota**  
Se sua conta Amazon Quick estiver integrada ao IAM Identity Center (recomendado), os grupos não serão gerenciados no aplicativo Quick. Em vez disso, os grupos são gerenciados no Centro de Identidade do IAM ou no provedor de identidades terceirizado que você configurou no Centro de Identidade do IAM. Os grupos são sincronizados automaticamente entre o Quick e o IAM Identity Center.

Administradores com credenciais do IAM que têm acesso ao console rápido podem organizar conjuntos de usuários em grupos que facilitam o gerenciamento do acesso e da segurança. Por exemplo, você pode criar um grupo de usuários com os quais você pode compartilhar ativos do Amazon Quick de uma só vez. Você pode criar e gerenciar grupos usando o console Amazon Quick ou o AWS Command Line Interface (AWS CLI). Você pode criar até dez mil grupos em um namespace. Se quiser criar mais de dez mil grupos em um namespace, entre em contato com o [Suporte da AWS](https://aws.amazon.com//contact-us/).

Use os tópicos abaixo para criar e modificar grupos no console do Amazon Quick ou com o Amazon Quick APIs.

**Topics**
+ [Crie um grupo com o console Amazon Quick](#creating-groups-console)
+ [Altere a descrição de um grupo com o console Amazon Quick](#group-description-console)
+ [Gerencie a associação a grupos no console Amazon Quick](#group-add-users-console)
+ [Crie e gerencie grupos com o AWS CLI](#creating-groups-cli)

## Crie um grupo com o console Amazon Quick
<a name="creating-groups-console"></a>

Use o procedimento a seguir para criar um grupo no console rápido.

**Para criar um grupo de usuários no console do Amazon Quick:**

1. Na página inicial do Amazon Quick, escolha **Manage Quick** e, em seguida, escolha **Manage groups**.

1. Escolha **NOVO GRUPO**.

1. Na página **Criar novo grupo**, insira o nome e a descrição do novo grupo nas caixas correspondentes.

1. Quando terminar, escolha **Criar** para criar o novo grupo.

**nota**  
Você não pode excluir um grupo do console Amazon Quick, mas você pode excluir um grupo com a AWS CLI. Para obter mais informações sobre como excluir um grupo do Amazon Quick com a AWS CLI, [consulte Criar e gerenciar grupos com a AWS](https://docs.aws.amazon.com/quicksight/latest/user/creating-groups-cli.html) CLI.

## Altere a descrição de um grupo com o console Amazon Quick
<a name="group-description-console"></a>

Depois de criar um novo grupo, você não pode alterar o título do grupo, mas pode alterar a descrição.

**Para alterar a descrição de um grupo:**

1. Na página inicial do Amazon Quick, escolha **Manage Quick** e, em seguida, escolha **Manage groups**.

1. Escolha o grupo que deseja alterar e selecione o link **Editar** ao lado da descrição do grupo.

1. Na caixa **Editar descrição** exibida, insira a nova descrição e escolha **Salvar**.

## Gerencie a associação a grupos no console Amazon Quick
<a name="group-add-users-console"></a>

Após criar um grupo, você pode adicionar e remover usuários na página **Gerenciar grupos**. Você não pode adicionar um usuário a um grupo se não tiver adicionado o usuário à sua conta. Para obter mais informações sobre como adicionar usuários à sua conta Amazon Quick, consulte [Gerenciamento do acesso de usuários dentro do Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/managing-users.html).

**Para adicionar um usuário a um grupo**

1. Na página inicial do Amazon Quick, escolha **Manage Quick** e, em seguida, escolha **Manage groups**.

1. Escolha o grupo ao qual você deseja adicionar um usuário e selecione **ADICIONAR USUÁRIO** no canto superior direito da página.

1. Insira o nome de usuário ou e-mail do usuário que deseja adicionar e escolha o usuário correto em **Pesquisar usuários**.

**Para remover um usuário de um grupo:**

1. Na página inicial do Amazon Quick, escolha **Manage Quick** e, em seguida, escolha **Manage groups**.

1. Escolha o grupo do qual você deseja remover um usuário.

1. Encontre o usuário que deseja remover e selecione **Remover**.

Escolher **Remover** remove automaticamente o usuário selecionado do grupo.

Você também pode pesquisar um membro do grupo inserindo o nome completo do usuário na barra de pesquisa no lado direito da página do grupo.

## Crie e gerencie grupos com o AWS CLI
<a name="creating-groups-cli"></a>

Antes de começar, verifique se você tem o AWS CLI instalado. Para obter mais informações, consulte [Instalando a AWS CLI no Guia](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) do usuário da *AWS CLI*.

Use o procedimento a seguir para criar um grupo de usuários do Quick.

1. Abra uma janela do terminal. Se você estiver usando o Microsoft Windows, abra um prompt de comando.

1. Digite o seguinte comando no prompt para criar um grupo. Substitua pelos valores corretos dos seus parâmetros.

   ```
   aws quicksight create-group --aws-account-id=111122223333 --namespace=default --group-name="Sales-Management" --description="Sales Management - Forecasting" 
   ```

   Pode ser mais fácil criar o comando em um editor de texto antes de inseri-lo no prompt. Para obter mais informações `create-group` e outros comandos disponíveis, consulte a [referência da Amazon Quick API](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). 

1. Verifique se o grupo existe usando um comando semelhante a um dos seguintes. O comando a seguir lista todos os grupos.

   ```
   aws quicksight list-groups --aws-account-id 111122223333 --namespace default 
   ```

   O comando a seguir descreve um grupo específico.

   ```
   aws quicksight describe-group --aws-account-id 11112222333 --namespace default --group-name Sales
   ```

   O comando a seguir pesquisa grupos em um namespace Amazon Quick especificado.

   ```
   aws quicksight search-groups --region us-west-2 --aws-account-id 11112222333 --namespace default --filters "[{\"Operator\": \"StartsWith\", \"Name\": \"GROUP_NAME\", \"Value\": \"Mar\"}]"
   ```

1. Adicione um membro ao novo grupo, usando um comando semelhante ao seguinte.

   ```
    aws quicksight create-group-membership --aws-account-id 111122223333 --namespace default --group-name Sales --member-name Pat
   ```

   O comando a seguir determina se um usuário é membro de um grupo especificado.

   ```
   aws quicksight describe-group-membership --region us-west-2 --aws-account-id 11112222333 --namespace default --group-name Marketing-East --member-name user
   ```

Insira o comando apresentado a seguir no prompt para excluir um grupo. Substitua pelos valores corretos dos seus parâmetros.

```
aws quicksight delete-group --aws-account-id 111122223333 --namespace default --group-name Marketing-East
```

Pode ser mais fácil criar o comando em um editor de texto antes de inseri-lo no prompt. Para obter mais informações `delete-group` e outros comandos disponíveis, consulte a [referência da Amazon Quick API](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). 