

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

# Ativando seu agente AWS DataSync
<a name="activate-agent"></a>

Para concluir a criação do seu AWS DataSync agente, você deve ativá-lo. Esta etapa associa o agente ao seu Conta da AWS.

**nota**  
Você não pode ativar um agente em mais de um Conta da AWS e Região da AWS ao mesmo tempo.

## Pré-requisitos
<a name="activate-agent-prerequisites"></a>

Para ativar seu DataSync agente, verifique se você tem as seguintes informações:
+ O [endpoint DataSync de serviço](choose-service-endpoint.md) com o qual você está ativando seu agente.

  Se você estiver usando um endpoint de serviço da VPC, precisará destes detalhes:
  + ID do endpoint de serviço da VPC.
  + A sub-rede em que o endpoint de serviço da VPC está localizado.
  + O grupo de segurança que permite o tráfego necessário para usar endpoints de [serviço DataSync VPC](datasync-network.md#using-vpc-endpoint).
+ O endereço IP ou o nome do domínio do agente.

  Como você encontra isso depende do tipo de agente que você [implanta](deploy-agents.md). Por exemplo, se o agente for uma instância do Amazon EC2, você poderá encontrar o endereço IP na página da instância no console do Amazon EC2.

**nota**  
Para endpoints FIPS VPC, use AWS CLI a API or. DataSync 

## Obtenção de uma chave de ativação
<a name="get-activation-key"></a>

Você pode obter uma chave de ativação para seu DataSync agente implantado de algumas maneiras diferentes. Algumas opções requerem acesso ao agente na porta 80 (HTTP). Se você usar uma dessas opções, DataSync feche a porta depois de ativar o agente.

**nota**  
As chaves de ativação do agente expiram em 30 minutos se não forem usadas.

------
#### [ DataSync console ]

Ao [ativar seu agente no DataSync console](#activate-agent-how-to), você DataSync pode obter a chave de ativação para você usando a opção **Obter automaticamente a chave de ativação do seu agente**.

Para usar essa opção, é necessário que o navegador possa alcançar o agente na porta 80.

------
#### [ Agent local console ]

Ao contrário das outras opções para obter uma chave de ativação, essa opção não exige que o agente esteja acessível na porta 80.

1. Faça login no [console local](local-console-vm.md#local-console-login) da máquina virtual (VM) do agente ou na instância do Amazon EC2.

1. No menu principal **AWS DataSync Ativação - Configuração**, digite **0** para obter uma chave de ativação.

1. Insira o em Região da AWS que você está ativando seu agente.

1. Insira o tipo de endpoint de serviço que seu agente está usando.

1. Copie a chave de ativação exibida.

   Por exemplo: `F0EFT-7FPPR-GG7MC-3I9R3-27DOH`

   Você especifica essa chave ao [ativar o agente](#activate-agent-how-to).

------
#### [ CLI ]

Com as ferramentas padrão do Unix, você pode executar uma solicitação de `curl` no endereço IP do agente para obter a chave de ativação.

Para usar essa opção, é necessário que o cliente possa alcançar o agente na porta 80. Você pode executar o seguinte comando para verificar:

```
nc -vz agent-ip-address 80
```

Depois de confirmar que pode alcançar o agente, execute um dos comandos a seguir, dependendo do tipo de endpoint de serviço que você esteja usando:
+ **Endpoints de serviço público**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&no_redirect"
  ```
+ **Endpoints de serviço FIPS**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&endpointType=FIPS&no_redirect"
  ```
+ **Endpoints de serviço da VPC**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&privateLinkEndpoint=vpc-endpoint-ip-address&endpointType=PRIVATE_LINK&no_redirect"
  ```
+ **Endpoints de serviço de FIPS VPC**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&privateLinkEndpoint=vpc-endpoint-ip-address&endpointType=FIPS_PRIVATE_LINK&no_redirect"
  ```

**nota**  
Para encontrar o`vpc-endpoint-ip-address`, abra o [console da Amazon VPC](https://console.aws.amazon.com/vpc/), escolha **Endpoints e selecione seu endpoint** de serviço VPC DataSync . Na guia **Sub-redes**, localize o endereço IP da [sub-rede do endpoint de serviço da VPC](choose-service-endpoint.md#datasync-in-vpc). Esse é o endereço IP do endpoint.

Esse comando retorna uma chave de ativação. Por exemplo:

`F0EFT-7FPPR-GG7MC-3I9R3-27DOH`

Você especifica essa chave ao [ativar o agente](#activate-agent-how-to).

------

## Ativação do agente do
<a name="activate-agent-how-to"></a>

Você tem várias opções para ativar seu DataSync agente. Depois de ativado, a AWS [gerencia o agente](managing-agent.md) para você.

------
#### [ DataSync console ]

1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação à esquerda, escolha **Agentes** e, em seguida, escolha **Criar agente**.

1. Na seção **Endpoint de serviço**, faça o seguinte para especificar o endpoint de serviço para o agente:
   + Para um endpoint de serviço público, escolha **Endpoints de serviço público** em. *your current Região da AWS*
   + Para um endpoint de serviço FIPS, escolha endpoints de **serviço FIPS** em. *your current Região da AWS*
   + Para um endpoint de serviço da VPC, faça o seguinte:
     + Escolha **Endpoints da VPC usando AWS PrivateLink**.
     + Em **Endpoint da VPC**, escolha o endpoint de serviço da VPC que você deseja que o agente use.
     + Em **Sub-rede**, escolha a sub-rede em que seu endpoint de serviço da VPC está localizado.
     + Em **Grupo de segurança**, escolha o grupo de segurança que permite o tráfego necessário para usar endpoints de [serviço DataSync VPC](datasync-network.md#using-vpc-endpoint).

1. Na seção **Chave de ativação**, faça uma das seguintes alternativas para especificar a chave de ativação do agente:
   + Escolha **Obter automaticamente a chave de ativação do seu agente** DataSync para obter a chave para você. 
     + Em **Endereço do agente**, insira o endereço IP ou nome de domínio do agente.
     + Escolha **Obter chave**.

       Se houver falha na ativação, [verifique sua configuração de rede](datasync-network.md) com base no tipo de endpoint de serviço que você está usando.
   + Escolha **Inserir a chave de ativação do agente manualmente** se não quiser uma conexão entre o navegador e o agente.
     +  [Obtenha a chave](#get-activation-key) no console local do agente ou usando um comando `curl`.
     + De volta ao DataSync console, insira a chave no campo **Chave de ativação**.

1. (Recomendado) Em **Nome do agente**, dê ao agente um nome de que você possa se lembrar.

1. (Opcional) Em **Tags**, insira valores nos campos **Chave** e **Valor** para marcar seu agente.

   Tags ajudam a gerenciar, filtrar e procurar recursos AWS . 

1. Escolha **Criar agente**.

1. Na página **Agentes**, verifique o agente está usando o serviço correto para o tipo endpoint.
**nota**  
Nesse ponto, talvez você note que o agente está offline. Isso acontece por um breve tempo após a ativação do agente.

------
#### [ AWS CLI ]

1. Depois de [obter a chave de ativação](#get-activation-key), copie um dos seguintes comandos `create-agent`, dependendo do tipo de endpoint de serviço que você está usando:
   + **Endpoint de serviço público ou FIPS**:

     ```
     aws datasync create-agent \
       --activation-key activation-key \
       --agent-name name-for-agent
     ```
   + **Endpoint de serviço VPC ou FIPS VPC**:

     ```
     aws datasync create-agent \
       --activation-key activation-key \
       --agent-name name-for-agent \
       --vpc-endpoint-id vpc-endpoint-id \
       --subnet-arns subnet-arn \
       --security-group-arns security-group-arn
     ```

1. Em `--activation-key`, especifique a [chave de ativação do agente](#get-activation-key).

1. (Recomendado) Em `--agent-name`, especifique um nome para o agente de que você possa se lembrar.

1. Se você estiver usando um endpoint de serviço da VPC, especifique as seguintes opções:
   + Em `--vpc-endpoint-id`, especifique o ID do endpoint de serviço da VPC que você está usando.
   + Em `--subnet-arns`, especifique o ARN da sub-rede em que o endpoint de serviço da VPC está localizado.
   + Para`--security-group-arns`, especifique o ARN do grupo de segurança que permite o tráfego necessário para usar endpoints de serviço DataSync [VPC](datasync-network.md#using-vpc-endpoint).

1. Execute o comando `create-agent`.

   Você recebe uma resposta com o ARN do agente que acabou de ativar. Por exemplo:

   ```
   {
       "AgentArn": "arn:aws:datasync:us-east-1:111222333444:agent/agent-0b0addbeef44baca3"
   }
   ```

1. Verifique se o agente está ativado executando o comando `list-agents`:

   ```
   aws datasync list-agents
   ```
**nota**  
Nesse ponto, talvez você note que o `Status` do agente é `OFFLINE`. Isso acontece por um breve tempo após a ativação do agente.

------
#### [ DataSync API ]

Depois de [obter sua chave de ativação](#get-activation-key), ative seu agente usando a [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)operação.

**nota**  
Quando terminar, talvez você note que o agente está offline. Isso acontece por um breve tempo após a ativação do agente.

------

## Próximas etapas
<a name="activate-agent-next-steps"></a>
+ [Verifique a conexão do seu agente](test-agent-connections.md) com seu sistema de armazenamento e com o DataSync serviço.
+ Se você tiver problemas ao tentar ativar o agente, obtenha ajuda em [solução de problemas](troubleshooting-datasync-agents.md).
+ Crie o DataSync local que você deseja usar com seu agente. Pode ser um local [on-premises](transferring-on-premises-storage.md) ou em [outra nuvem](transferring-other-cloud-storage.md).