PutGCSObject 2025.10.9.21

Bundle

org.apache.nifi | nifi-gcp-nar

Description

Writes the contents of a FlowFile as an object in a Google Cloud Storage.

Tags

archive, gcs, google, google cloud, put

Input Requirement

REQUIRED

Supports Sensitive Dynamic Properties

false

Properties

PropertyDescription
File Resource ServiceFile Resource Service providing access to the local resource to be transferred
GCP Credentials Provider ServiceThe Controller Service used to obtain Google Cloud Platform credentials.
Resource Transfer SourceThe source of the content to be transferred
gcp-project-idGoogle Cloud Project ID
gcp-retry-countHow many retry attempts should be made before routing to the failure relationship.
gcs-bucketBucket of the object.
gcs-content-disposition-typeType of RFC-6266 Content Disposition to be attached to the object
gcs-content-typeContent Type for the file, i.e. text/plain
gcs-keyName of the object.
gcs-object-aclAccess Control to be attached to the object uploaded. Not providing this will revert to bucket defaults.
gcs-object-crc32cCRC32C Checksum (encoded in Base64, big-Endian order) of the file for server-side validation.
gcs-overwrite-objectIf false, the upload to GCS will succeed only if the object does not exist.
gcs-server-side-encryption-keyAn AES256 Encryption Key (encoded in base64) for server-side encryption of the object.
gzip.content.enabledSignals to the GCS Blob Writer whether GZIP compression during transfer is desired. False means do not gzip and can boost performance in many cases.
proxy-configuration-serviceSpecifies the Proxy Configuration Controller Service to proxy network requests.
storage-api-urlOverrides the default storage URL. Configuring an alternative Storage API URL also overrides the HTTP Host header on requests as described in the Google documentation for Private Service Connections.

Relationships

NameDescription
failureFlowFiles are routed to this relationship if the Google Cloud Storage operation fails.
successFlowFiles are routed to this relationship after a successful Google Cloud Storage operation.

Writes attributes

NameDescription
gcs.bucketBucket of the object.
gcs.keyName of the object.
gcs.sizeSize of the object.
gcs.cache.controlData cache control of the object.
gcs.component.countThe number of components which make up the object.
gcs.content.dispositionThe data content disposition of the object.
gcs.content.encodingThe content encoding of the object.
gcs.content.languageThe content language of the object.
mime.typeThe MIME/Content-Type of the object
gcs.crc32cThe CRC32C checksum of object’s data, encoded in base64 in big-endian order.
gcs.create.timeThe creation time of the object (milliseconds)
gcs.update.timeThe last modification time of the object (milliseconds)
gcs.encryption.algorithmThe algorithm used to encrypt the object.
gcs.encryption.sha256The SHA256 hash of the key used to encrypt the object
gcs.etagThe HTTP 1.1 Entity tag for the object.
gcs.generated.idThe service-generated for the object
gcs.generationThe data generation of the object.
gcs.md5The MD5 hash of the object’s data encoded in base64.
gcs.media.linkThe media download link to the object.
gcs.metagenerationThe metageneration of the object.
gcs.ownerThe owner (uploader) of the object.
gcs.owner.typeThe ACL entity type of the uploader of the object.
gcs.uriThe URI of the object as a string.

See also