PutS3Object 2025.10.2.19¶
Pacote¶
org.apache.nifi | nifi-aws-nar
Descrição¶
Grava o conteúdo de um FlowFile como um objeto S3 em um bucket S3 da Amazon.
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 |
Controle de cache |
Define o cabeçalho HTTP Cache-Control indicando as diretivas de cache do objeto associado. Várias diretivas são separadas por vírgulas. |
Canned ACL |
ACL pré-definida da Amazon para um dos seguintes objetos: BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; será ignorada se qualquer outra propriedade de ACL/permissão/proprietário for especificada |
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. |
Disposição do conteúdo |
Sets the Content-Disposition HTTP header indicating if the content is intended to be displayed inline or should be downloaded. Possible values are “inline” or “attachment”. If this property is not specified, object “s content-disposition will be set to filename. When” attachment “is selected,”; filename=”plus object key are automatically appended to form final value” attachment; filename=»filename.jpg»”. |
Tipo de conteúdo |
Sets the Content-Type HTTP header indicating the type of content stored in the associated object. The value of this header is a standard MIME type. AWS S3 Java client will attempt to determine the correct content type if one hasn’t been set yet. Users are responsible for ensuring a suitable content type is set when uploading streams. If no content type is provided and cannot be determined by the filename, the default content type «application/octet-stream» will be used. |
Custom Signer Class Name |
Fully qualified class name of the custom signer class. The signer must implement com.amazonaws.auth. Signer interface. |
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. |
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. |
Regra de tempo de expiração |
|
Serviço de recurso de arquivo |
O serviço de recurso de arquivo que fornece acesso ao recurso local a ser transferido |
Lista de usuários FullControl |
Uma lista separada por vírgulas de IDs de usuários Amazon ou endereços de e-mail que especifica quem deve ter o controle total de um objeto |
Tamanho da parte Multipart |
Especifica o tamanho da peça para uso quando a PutS3Multipart Upload API é usada. Os FlowFiles serão divididos em partes desse tamanho para o processo de upload, mas a última parte enviada pode ser menor, pois não é preenchida. O intervalo válido é de 50MB a 5GB. |
Limite multipart |
Specifies the file size threshold for switch from the PutS3Object API to the PutS3MultipartUpload API. Flow files bigger than this limit will be sent using the stateful multipart process. The valid range is 50MB to 5GB. |
Intervalo AgeOff de upload multipart |
Specifies the interval at which existing multipart uploads in AWS S3 will be evaluated for ageoff. When processor is triggered it will initiate the ageoff evaluation if this interval has been exceeded. |
Limite de idade máxima para upload multipart |
Specifies the maximum age for existing multipart uploads in AWS S3. When the ageoff process occurs, any upload older than this threshold will be aborted. |
Chave do objeto |
A chave do objeto S3 a ser usada. Isso é análogo a um nome de arquivo nos sistemas de arquivo tradicionais. |
Object Tags Prefix |
Specifies the prefix which would be scanned against the incoming FlowFile “s attributes and the matching attribute’s name and value would be considered as the outgoing S3 object “s Tag name and Tag value respectively. For Ex: If the incoming FlowFile carries the attributes tagS3country, tagS3PII, the tag prefix to be specified would be” tagS3” |
Proprietário |
O ID Amazon a ser usado para o proprietário do objeto |
Lista de usuários ACL de leitura |
Uma lista separada por vírgulas de IDs de usuário da Amazon ou endereços de e-mail que especifica quem deve ter permissões para ler a lista de controle de acesso de um objeto |
Lista de usuários com permissão de leitura |
Uma lista separada por vírgulas de IDs de usuários Amazon ou endereços de e-mail que especifica quem deve ter acesso de leitura a um objeto |
Região |
A região AWS à qual você deve se conectar. |
Remove Tag Prefix |
Se definido como “True”, o valor fornecido para “Object Tags Prefix” (Prefixo de tags de objeto) será removido do(s) atributo(s) e, em seguida, considerado como o nome da tag. Por exemplo: se o FlowFile de entrada tiver os atributos tagS3country, tagS3PII e o prefixo for definido como “tagS3”, os valores de tag correspondentes serão “country” e “PII“ |
Fonte de transferência de recursos |
A fonte do conteúdo a ser transferido |
Serviço de contexto SSL |
Especifica um serviço de contexto SSL opcional que, se fornecido, será usado para criar conexões |
Server Side Encryption |
Especifica o algoritmo usado para a criptografia do lado do servidor. |
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. |
Classe de armazenamento |
|
Temporary Directory Multipart State |
Diretório no qual, para uploads multipart, o processador salvará localmente o estado de rastreamento do ID de upload e as partes carregadas que devem ser fornecidas para concluir o upload. |
Use Chunked Encoding |
Ativa/desativa a codificação em partes para solicitações de upload. Defina-o como falso somente se seu ponto de extremidade não for compatível com o upload em partes. |
Use Path Style Access |
O acesso no estilo de caminho pode ser aplicado definindo essa propriedade como verdadeiro. Defina-o como verdadeiro se seu ponto de extremidade não for compatível com solicitações do tipo virtual-hosted, apenas com solicitações do tipo path. |
Lista de usuários ACL de gravação |
Uma lista separada por vírgulas de IDs de usuário Amazon ou endereços de e-mail que especifica quem deve ter permissões para alterar a lista de controle de acesso de um objeto |
Lista de usuários com permissão de gravação |
Uma lista separada por vírgulas de IDs de usuário Amazon ou endereços de e-mail que especifica quem deve ter acesso de gravação para um objeto |
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. |
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 bucket S3 onde o objeto foi colocado no S3 |
s3.key |
A chave S3 onde o objeto foi armazenado no S3 |
s3.contenttype |
O tipo de conteúdo S3 do objeto S3 que foi colocado no S3 |
s3.version |
A versão do objeto S3 colocada no S3 |
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.etag |
A ETag do objeto S3 |
s3.contentdisposition |
A disposição do conteúdo do objeto S3 colocado no S3 |
s3.cachecontrol |
O cabeçalho de controle de cache do objeto S3 |
s3.uploadId |
O uploadId usado para fazer o upload do objeto ao S3 |
s3.expiration |
Uma forma legível para humanos da data de expiração do objeto S3, se houver uma definida |
s3.sseAlgorithm |
O algoritmo de criptografia do lado do servidor do objeto |
s3.usermetadata |
Um formulário legível para humanos dos metadados do usuário do objeto S3, se algum tiver sido definido |
s3.encryptionStrategy |
O nome da estratégia de criptografia, se alguma tiver sido definida |