AWS S3 Get¶

Introdução¶

O plug-in AWS S3 Get lê, renomeia ou exclui um arquivo do Amazon AWS S3. Um arquivo lido pode ser usado como fonte em uma operação.

Este plugin está disponível por padrão em grupos de agentes de nuvem Jitterbit e também pode ser associado a grupos de agentes privados.

Esta página detalha as etapas para usar o plugin AWS S3 Get:

1. Baixe e adicione o plugin
2. Associe o plugin a um grupo de agentes
3. Atribuir o plugin a uma fonte
4. Defina variáveis globais para o plugin
5. Configuração completa da operação

Criptografia¶

O plugin AWS S3 Get passa o ID da chave de acesso AWS S3 fornecido e a chave de acesso secreta (descrita abaixo em Definir variáveis globais para o plugin) para a Amazon. A segurança é tratada pela Amazon conforme descrito na documentação da Amazon sobre Credenciais de segurança da AWS.

Uso¶

O plugin AWS S3 Get pode ser usado sempre que você precisar recuperar, renomear ou excluir arquivos da AWS.

Funcionalidade Adicional¶

Além disso, essas opções oferecem funcionalidade adicional além do plugin AWS S3 Get:

• AWS S3 Create: AWS S3 create é um plugin fornecido pelo Jitterbit usado para carregar um arquivo no Amazon AWS S3 como um alvo dentro de uma operação em Design Studio.

• API REST da AWS: A API REST da AWS pode ser acessada por meio de uma fonte HTTP ou alvo HTTP em Design Studio. Durante a configuração, pode ser necessário usar o gerador HMAC-SHA256 plugin dependendo do seu método de autenticação. Se precisar de assistência, por favor contate o suporte.

Baixe e Adicione o Plugin¶

O plugin AWS S3 Get é um plugin Jitterbit padrão que já está disponível no Management Console Plugins e não precisa ser baixado ou adicionado à organização.

Se orientado pelo suporte, este plugin pode ser baixado no link fornecido abaixo e adicionado à organização (veja Adicionar novos plugins em Personalizações > Plug-ins).

• Jitterbit AWS S3 Obter 1.0.0.0 (ZIP)

Associe o Plugin a um Grupo de Agentes¶

O plugin AWS S3 Get é associado a grupos de agentes de nuvem Jitterbit por padrão.

Se estiver usando um grupo de agentes privados, antes de poder usar o plugin, você deve associá-lo ao grupo de agentes privados para tornar o plugin disponível em todos os agentes do grupo (consulte Associar grupos de agentes em Personalizações > Plug-ins).

O plugin está listado no Management Console Plugins página com um nome de exibição de Jitterbit AWS S3 Get.

Atribuir o Plugin a uma Fonte¶

Em um projeto do Design Studio, você deve atribuir o plugin a uma fonte dentro de uma operação. Um exemplo de configuração de operação é fornecido no final desta página.

Dentro do projeto:

1. Crie uma operação. Qualquer operação usando uma fonte pode ser usada.
2. Crie uma fonte fictícia à qual o plugin será atribuído. Esta fonte é usada como espaço reservado e não será realmente lida. Recomendamos usar uma fonte de variável global. Se outras fontes de tipo de arquivo forem usadas, como Armazenamento Temporário, arquivo local ou FTP, durante a configuração da fonte, é recomendável fornecer um valor Obter arquivos de [file].[ext].
3. Atribua o plugin à fonte. Para fazer isso, clique com o botão direito do mouse na fonte e selecione Plugin. No pop-up, em Plugins disponíveis, selecione "Jitterbit AWS S3 Get" e clique em Atribuir. Em seguida, clique em OK.

Definir Variáveis Globais para o Plugin¶

Para que um plugin atribuído a uma fonte seja funcional, quaisquer variáveis globais exigido pelo plugin deve ser definido. Essas variáveis são definidas em um script, que deve ser colocado antes da fonte na operação para que as variáveis possam ser inicializadas.

Para adicionar um script antes da fonte:

1. Clique com o botão direito na fonte da operação e selecione Inserir antes disso > Script.

2. Crie um novo Jitterbit Script que define variáveis usadas pelo plug-in para autenticação com seu bucket S3 e leitura do arquivo especificado. Um modelo de script para variáveis obrigatórias é fornecido abaixo, seguido de documentação sobre todas as variáveis possíveis que podem ser incluídas no script.

   AWS S3 Get Script

   <trans>
   $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
   $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
   $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
   $AWS.S3.OBJECT_KEY="<myfile.txt>";
   </trans>
   

Configuração Completa da Operação¶

A parte do plug-in da configuração da operação é concluída depois que você tem (1) o script que define as variáveis a serem usadas com o plug-in e (2) o plug-in atribuído a uma fonte na operação.

Para concluir a configuração da sua operação, defina um destino para arquivar seus dados S3 ou adicione um destino e uma transformação se desejar transformar seus dados antes de atingir o destino.