FetchS3Object 2025.5.31.15

Pacote

org.apache.nifi | nifi-aws-nar

Descrição

Recupera o conteúdo de um objeto S3 e o grava no conteúdo de um objeto FlowFile

Tags

AWS, Amazon, Buscar, Obter, S3

Requisito de entrada

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Serviço de provedor de credenciais AWS

O Controller Service que é usado para obter o provedor de credenciais AWS

Bucket

O bucket S3 para interagir

Tempo limite de comunicação

O tempo de espera para estabelecer uma conexão com o AWS ou receber dados do AWS antes de atingir o tempo limite.

URL de substituição do ponto de extremidade

URL do ponto de extremidade a ser usado em vez do padrão do AWS, incluindo esquema, host, porta e caminho. As bibliotecas AWS selecionam um URL de ponto de extremidade com base na região AWS, mas essa propriedade substitui o URL do ponto de extremidade selecionado, permitindo o uso com outros pontos de extremidade compatíveis com S3.

Chave do objeto

A chave do objeto S3 a ser usada. Isso é análogo a um nome de arquivo nos sistemas de arquivo tradicionais.

Região

A região AWS à qual você deve se conectar.

Serviço de contexto SSL

Especifica um serviço de contexto SSL opcional que, se fornecido, será usado para criar conexões

Substituição do signatário

A biblioteca AWS S3 usa a Signature Version 4 por padrão, mas essa propriedade permite que você especifique o signatário da versão 2 para oferecer suporte a serviços compatíveis com S3 mais antigos ou até mesmo para conectar sua própria implementação de signatário personalizado.

Versão

A versão do objeto a ser baixada

custom-signer-class-name

Nome de classe totalmente qualificado da classe do assinador personalizado. O assinador deve implementar a interface com.amazonaws.auth.Signer.

custom-signer-module-location

Lista separada por vírgulas de caminhos para arquivos e/ou diretórios que contêm o arquivo JAR do assinador personalizado e suas dependências (se houver).

encryption-service

Especifica o Controller Service de criptografia usado para configurar solicitações. PutS3Object: para fins de compatibilidade com versões anteriores, esse valor é ignorado quando a opção “Criptografia do lado do servidor” é definida. FetchS3Object: só precisa ser configurado no caso das criptografias Chave de cliente do lado do servidor, KMS do lado do lado do cliente e Chave de cliente do lado do lado do cliente.

proxy-configuration-service

Especifica o serviço de Controller Service de configuração de proxy para a realização de proxy de solicitações de rede.

range-length

O número de bytes a serem baixados do objeto, a partir do início de intervalo. Um valor vazio ou um valor que se estenda além do final do objeto será lido até o final do objeto.

range-start

A posição de byte na qual se inicia a leitura do objeto. Um valor vazio ou um valor de zero começará a leitura no início do objeto.

requester-pays

Se verdadeiro, indica que o solicitante consente em pagar quaisquer encargos associados à recuperação de objetos do bucket S3. Isso define o cabeçalho “x-amz-request-payer” como “requester”.

Relações

Nome

Descrição

failure

Se o processador não puder processar um determinado FlowFile, ele será encaminhado para essa relação.

success

FlowFiles são encaminhados para essa relação após terem sido processados com sucesso.

Grava atributos

Nome

Descrição

s3.url

O URL que pode ser usado para acessar o objeto S3

s3.bucket

O nome do bucket S3

path

O caminho do arquivo

absolute.path

O caminho do arquivo

filename

O nome do arquivo

hash.value

A soma MD5 do arquivo

hash.algorithm

MD5

mime.type

Se o S3 fornecer o tipo de conteúdo/tipo MIME, esse atributo conterá esse arquivo

s3.etag

O ETag que pode ser usado para verificar se o arquivo foi alterado

s3.exception

O nome da classe da exceção gerada durante a execução do processador

s3.additionalDetails

O S3 forneceu detalhes da operação com falha

s3.statusCode

O código de erro HTTP (se disponível) da operação com falha

s3.errorCode

O moniker S3 da operação com falha

s3.errorMessage

A mensagem de exceção S3 da operação com falha

s3.expirationTime

Se o arquivo tiver uma data de expiração, esse atributo será definido, contendo os milissegundos desde a época em tempo UTC

s3.expirationTimeRuleId

O ID da regra que determina o tempo de expiração desse objeto

s3.sseAlgorithm

O algoritmo de criptografia do lado do servidor do objeto

s3.version

A versão do objeto S3

s3.encryptionStrategy

O nome da estratégia de criptografia que foi usada para armazenar o objeto S3 (se ele estiver criptografado)

Casos de uso

Obtenha um arquivo específico do S3

Casos de uso que envolvem outros componentes

Recupere todos os arquivos em um bucket S3

Recupere apenas arquivos do S3 que atendam a alguns critérios especificados

Recupere novos arquivos à medida que eles chegam em um bucket S3

Consulte também