Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

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 Amazon S3, a base usada para gerar instâncias de atividades 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 (consulte paleta de componentes de design).

Visão geral do conector

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

Juntas, uma conexão específica do Amazon S3 e suas atividades são chamadas de endpoint do Amazon S3:

Tipos de atividade do Amazon S3

  • Mover objeto: Move um objeto de um bucket do Amazon S3 para outro e deve ser usado como um destino em uma operação.

  • Excluir objeto: Exclui um objeto de um bucket do Amazon S3 e deve ser usado como um destino em uma operação.

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

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

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

Nota

Este conector é um Connector SDK, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

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 definido. Todas as atividades do conector exigem o s3:ListAllMyBuckets permissão. Além disso, atividades individuais exigem permissões específicas adicionais. A tabela a seguir resume as permissões necessárias:

Permissão necessária Funcionalidade
s3:ListAllMyBuckets Testando o connection e recuperando metadados de atividade durante a configuração da atividade
s3:PutObject e s3:GetBucketLocation Put Object activity execução
s3:GetObject, s3:ListBucket, e s3:GetObjectTagging(opcional) Get Object activity execução

Nota

O s3:GetObjectTagging a permissão é necessária somente quando a configuração opcional Incluir metadados de marcação na resposta estiver habilitada para a atividade Obter objeto.
s3:GetObject, s3:ListBucket, e s3:GetObjectTagging List Objects activity execução
s3:DeleteObject Delete Object activity execução
s3:GetObject e s3:PutObject Move Object activity execução

O conector Amazon S3 usa o AWS SDK para Java versão 2.29.34. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

Problema conhecido

As operações do Amazon S3 estão falhando

  • Resumo: Algumas operações existentes usando o conector Amazon S3 que estavam funcionando anteriormente começaram a falhar perto do período da versão 11.38.

  • Resolução: Se você tiver esse problema, adicione a permissão s3:GetObjectTagging para sua política AWS IAM para resolver esse problema.

Solução de problemas

Se você tiver problemas com o conector Amazon S3, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração de 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 você esteja usando a política da organização Desativar atualização automática do conector).

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

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

  4. Se estiver usando agentes privados, você pode habilitar conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

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

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

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

Problema conhecido

As operações do Amazon S3 estão falhando

  • Resumo: Algumas operações existentes usando o conector Amazon S3 que estavam funcionando anteriormente começaram a falhar perto do período da versão 11.38.

  • Resolução: Se você tiver esse problema, adicione a permissão s3:GetObjectTagging para sua política AWS IAM para resolver esse problema.