Ir para o conteúdo

Conector Amazon S3 para Jitterbit Integration Studio

Resumo

O conector Amazon S3 estabelece acesso ao Amazon S3.

O conector Amazon S3 fornece uma interface para criar uma conexão com o Amazon S3, a base utilizada para gerar instâncias de atividades do Amazon S3. Essas atividades, uma vez configuradas, interagem com o Amazon S3 por meio da conexão.

O conector Amazon S3 é acessado na aba Endpoints e conectores do projeto da paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão Amazon S3. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão específica do Amazon S3 e suas atividades são referidos como um endpoint do Amazon S3:

Tipos de atividades do Amazon S3

  • Mover Objeto: Move um objeto de um bucket do Amazon S3 para outro e é destinado a ser usado como um alvo em uma operação.

  • Excluir Objeto: Exclui um objeto de um bucket do Amazon S3 e é destinado a ser usado como um alvo em uma operação.

  • Colocar Objeto: Coloca um objeto em um bucket do Amazon S3 e é destinado a ser usado como um alvo em uma operação.

  • Obter Objeto: Recupera um objeto de um bucket do Amazon S3 e é destinado a ser usado como uma fonte em uma operação.

  • Listar Objetos: Retorna alguns ou todos (até 100.000) dos objetos em um bucket do Amazon S3 e é destinado a ser usado como um alvo em uma operação.

Nota

Este conector é um conector baseado no Connector SDK, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector Amazon S3 requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

Para usar as atividades do conector Amazon S3, a instância do Amazon S3 deve ter certas permissões configuradas. Todas as atividades do conector requerem a permissão s3:ListAllMyBuckets. Além disso, atividades individuais requerem permissões específicas adicionais. A tabela a seguir resume as permissões necessárias:

Permissão necessária Funcionalidade
s3:ListAllMyBuckets Testar a conexão e recuperar metadados da atividade durante a configuração da atividade
s3:PutObject e s3:GetBucketLocation Execução da atividade Colocar Objeto
s3:GetObject, s3:ListBucket e s3:GetObjectTagging (opcional) Execução da atividade Obter Objeto

Nota

A permissão s3:GetObjectTagging é necessária apenas quando a configuração opcional Incluir metadados de marcação na Resposta está habilitada para a atividade Obter Objeto.
s3:GetObject, s3:ListBucket e s3:GetObjectTagging Execução da atividade Listar Objetos
s3:DeleteObject Execução da atividade Excluir Objeto
s3:GetObject e s3:PutObject Execução da atividade Mover Objeto

O conector Amazon S3 utiliza a API do Amazon Simple Storage Service. Consulte a documentação sobre as ações da API do Amazon S3 para obter informações sobre os nós e campos do esquema.

Solução de Problemas

Se você encontrar problemas com o conector Amazon S3, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desativar Atualização Automática do Conector).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.amazon" level="DEBUG"/>

Para mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

  1. Se estiver usando agentes privados, você pode verificar os registros do agente para mais informações.

  2. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.