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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be Bucket. |
| metadata | map | The engine reads the reserved keys name and project to resolve the identity of the manifest and its parent Project. |
| spec | Spec | Bucket configuration. See Spec. |
Spec
User-authored bucket configuration.
Visibility, location, storage class, notifications and content processors.
| Property | Type | Description |
|---|---|---|
| public | bool | If true, grants roles/storage.objectViewer to allUsers. Anyone can then read the objects without authentication. |
| description | string | Optional description. The engine sets it as the bucket description. If empty, the engine generates a default. |
| notifications | list of BucketNotificationConfig | Pub/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. |
| scanForMalware | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: scan uploaded objects for malware. |
| processors | Processors | Serverless content processors. If you enable at least one, the engine creates the processing pipeline for bucket writes. See Processors. |
| region | string | Location of the bucket and its data, which sets data residency. Default: the region of the parent Project. |
| storageClass | string | Default 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.
| Property | Type | Description |
|---|---|---|
| obscenityScanner | bool | If true, the processor service scans uploaded objects for adult or violent content with the Google Cloud Vision API. |
| converters | list of BucketImageConverterConfig | Rules 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.
| Property | Type | Description |
|---|---|---|
| format | string | Format to re-encode uploaded images to: WEBP, PNG or JPEG. |
| maxWidth | int64 | Maximum output width in pixels (minimum 100). The converter scales down larger images. |
| maxHeight | int64 | Maximum 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.
| Property | Type | Description |
|---|---|---|
| topic | string | Name of the PubSub manifest that receives the notifications. It must exist. |
| events | list of string | Storage event types that trigger a notification: OBJECT_FINALIZE (new object) or OBJECT_METADATA_UPDATE (metadata change). |