

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á.

# Marcar uma instância Connect Customer
<a name="tagging-connect-instance"></a>

A marcação de instâncias permite que você marque Connect Customer instâncias e crie autorizações personalizadas por meio do controle de acesso baseado em tags (TBAC). Para ajudar você a gerenciar suas Connect Customer instâncias, você pode atribuir seus próprios metadados na forma de tags à instância. Se você tiver várias Connect Customer instâncias em uma única AWS conta, cada uma servindo funções diferentes ou atendendo a linhas específicas de negócios, o uso de tags pode ajudá-lo a organizar e aplicar melhor as políticas de controle de acesso baseado em tags (TBAC) a essas instâncias para melhorar o gerenciamento e o controle.

As [etiquetas da AWS](tagging.md) funcionam como uma ferramenta útil para organizar os recursos da AWS . Elas consistem em pares de valor-chave que ajudam você a categorizar os recursos com base em critérios como finalidade, proprietário ou ambiente. Isso permite que você identifique e gerencie seus recursos. Connect Customer, permite que você adicione tags às suas instâncias diretamente do AWS console ou utilizando public APIs.

## Marcar Connect Customer instâncias na criação
<a name="tagging-connect-instance-at-creation"></a>

1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Escolha **Add an instance**.  
![Adicione uma instância que você deseja marcar.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-instance-at-creation-1.png)

1. Em **Definir identidade**, selecione o tipo de **Gerenciamento de identidades** que você gostaria de usar, insira um **URL de acesso** do cliente e escolha **Avançar**.  
![Defina as opções do gerenciamento de identidades e insira um URL de acesso do cliente.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-instance-at-creation-2.png)

1. Na seção **Adicionar administrador**, você pode escolher a opção **Adicionar nova tag** se quiser adicionar etiquetas à instância.  
![Você pode optar por adicionar etiquetas nesta etapa da criação da instância.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-instance-at-creation-3.png)

1. Insira um par de `Value` e `Key` e escolha **Próximo**.

1. Depois de fazer as configurações desejadas nas etapas **Definir telefonia** e **Armazenamento de dados**, revise as configurações e escolha **Criar instância**.  
![Crie a instância depois de analisar as configurações desejadas.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-instance-at-creation-4.png)

1. Depois que a instância for criada, navegue até a página **Visão geral da conta** da instância, e as etiquetas que você adicionou aparecerão na seção **Etiquetas**.  
![Os caracteres depois do último /.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-instance-at-creation-5.png)

## Marcar uma instância existente Connect Customer
<a name="tagging-existing-connect-instance"></a>

1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Selecione uma instância existente à qual você gostaria de adicionar etiquetas também.  
![Selecione uma instância que você gostaria de marcar.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-existing-instance-1.png)

1. Na **Visão geral da conta**, escolha **Adicionar nova tag**.  
![Escolha o botão Adicionar etiqueta.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-existing-instance-2.png)

1. Insira um par de `Value` e `Key` e escolha **Próximo**. Você pode adicionar até 50 etiquetas em uma única instância.  
![Adicione pares de chave e valor para as etiquetas.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-existing-instance-3.png)

1. Escolha **Salvar** para adicionar as etiquetas à instância.  
![Escolha Salvar para adicionar as etiquetas à instância.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/tag-existing-instance-4.png)

## Marcar uma Connect Customer instância usando a API
<a name="tagging-connect-instance-api"></a>

Para marcar Connect Customer instâncias usando o público APIs, consulte [TagResource[UntagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_UntagResource.html)](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)e.

## Políticas do IAM de exemplo para cenários com e sem etiquetas de instância
<a name="tagging-connect-instance-sample-iam-policies"></a>

Para TBAC em instâncias, você pode definir políticas do IAM com base em etiquetas da instância e atribuí-las a perfis do IAM para controlar o acesso a instâncias específicas. Veja a seguir exemplos de cenários e exemplos de políticas do IAM sobre como usar condições em tags ou condições em recursos IDs.

**Cenário 1**: controle de acesso a uma instância específica do Connect Customer por meio de um perfil do IAM usando tags associadas à instância. A seguinte política permite acessar somente instâncias marcadas com chave: `Environment` e valor: `Dev`.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "connect:*",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/Environment": "Dev"
        }
      }
    }
  ]
}
```

------

**Cenário 2**: controle de acesso a uma instância específica e todos os recursos dentro da instância sem usar etiquetas.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "connect:*",
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "connect:InstanceId": [
                        "{{AllowedInstanceID-1}}",
                        "{{AllowedInstanceID-2}}"
                    ]
                }
            }
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": "connect:*",
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringEquals": {
                   "connect:InstanceId": "{{DeniedInstanceID-1}}"
                }
            }
        }
    ]
}
```

------

## Informações adicionais sobre marcação da instância
<a name="tagging-connect-instance-additional-info"></a>

**Replicação de instâncias:** quando você cria uma [réplica da sua Connect Customer instância existente](create-replica-connect-instance.md) em outra região usando a [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API, as tags da instância de origem não serão automaticamente marcadas para a instância recém-replicada. Você precisará marcar manualmente a instância replicada.

**Herança de tags:** quando você marca uma Connect Customer instância, todos os recursos subjacentes Connect Customer, como perfis de roteamento e filas, não herdam as tags da instância. Para saber como controlar o acesso granular a recursos específicos em Connect Customer, veja como configurar um acesso mais granular usando o controle de acesso [baseado em tags](tag-based-access-control.md).