Skip to main content

Bucket

Bucket​

Managed Cloud Storage bucket.

Sets the visibility, storage class and region of the bucket. Content processors add a Cloud Run service, a Pub/Sub topic, a bucket notification and an Eventarc trigger that process uploaded objects.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be Bucket.
metadatamapThe engine reads the reserved keys name and project to resolve the identity of the manifest and its parent Project.
specSpecBucket configuration. See Spec.

Spec​

User-authored bucket configuration.

Visibility, location, storage class, notifications and content processors.

PropertyTypeDescription
publicboolIf true, grants roles/storage.objectViewer to allUsers. Anyone can then read the objects without authentication.
descriptionstringOptional description. The engine sets it as the bucket description. If empty, the engine generates a default.
notificationslist of BucketNotificationConfigPub/Sub topics and events to emit for this bucket. Each topic must exist as a PubSub manifest under the same parent Project. The engine does not yet create these notifications. Only the processor pipeline creates bucket notifications. See BucketNotificationConfig.
scanForMalwareboolNOT YET IMPLEMENTED. The engine ignores this field. Intended use: scan uploaded objects for malware.
processorsProcessorsServerless content processors. If you enable at least one, the engine creates the processing pipeline for bucket writes. See Processors.
regionstringLocation of the bucket and its data, which sets data residency. Default: the region of the parent Project.
storageClassstringDefault storage class of the objects. One of STANDARD, NEARLINE, COLDLINE or ARCHIVE. The engine does not yet apply it: it creates every bucket with STANDARD.

Processors​

Serverless processing pipeline for uploaded objects.

If you enable any processor, the engine creates a Cloud Run service with a Pub/Sub topic, bucket notification and Eventarc trigger. The service runs on each object-finalize event and gets the Processors block as JSON in APP_CONFIG.

PropertyTypeDescription
obscenityScannerboolIf true, the processor service scans uploaded objects for adult or violent content with the Google Cloud Vision API.
converterslist of BucketImageConverterConfigRules that convert uploaded images, for example resize or format change. See BucketImageConverterConfig.

BucketImageConverterConfig​

Automatic image conversion for a bucket.

NOT YET IMPLEMENTED. The engine ignores this message. It will re-encode and resize uploaded images.

PropertyTypeDescription
formatstringFormat to re-encode uploaded images to: WEBP, PNG or JPEG.
maxWidthint64Maximum output width in pixels (minimum 100). The converter scales down larger images.
maxHeightint64Maximum output height in pixels (minimum 100). The converter scales down larger images.

BucketNotificationConfig​

Bucket notification to Pub/Sub.

Sends an event record to a Pub/Sub topic when objects in the bucket change.

PropertyTypeDescription
topicstringName of the PubSub manifest that receives the notifications. It must exist.
eventslist of stringStorage event types that trigger a notification: OBJECT_FINALIZE (new object) or OBJECT_METADATA_UPDATE (metadata change).