gcloud: Wed Jun 28 10:42:37 UTC 2023

gcloud/beta/pubsub/subscriptions/create

@@ -12,8 +12,15 @@ SYNOPSIS
         [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL]
         [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE]
         [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages]
-        [--bigquery-table=BIGQUERY_TABLE
+        [[--bigquery-table=BIGQUERY_TABLE
           : --drop-unknown-fields --use-topic-schema --write-metadata]
+          | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET
+          : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX
+          --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX
+          --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES
+          --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION
+          --cloud-storage-output-format=OUTPUT_FORMAT;
+          default="text" --cloud-storage-write-metadata]]
         [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS
           [--dead-letter-topic=DEAD_LETTER_TOPIC
           : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]]
@@ -169,6 +176,49 @@ OPTIONAL FLAGS
             Whether or not to write message metadata including message ID,
             publish timestamp, ordering key, and attributes to BigQuery.
 
+       Cloud Storage Config Options. The Cloud Pub/Sub service account
+       associated with the enclosing subscription's parent project (i.e.,
+       service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+       have permission to write to this Cloud Storage bucket and to read this
+       bucket's metadata.
+
+         --cloud-storage-bucket=CLOUD_STORAGE_BUCKET
+            A Cloud Storage bucket to which to write messages for this
+            subscription.
+
+            This flag argument must be specified if any of the other arguments
+            in this group are specified.
+
+         --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX
+            The prefix for Cloud Storage filename.
+
+         --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX
+            The suffix for Cloud Storage filename.
+
+         --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES
+            The maximum bytes that can be written to a Cloud Storage file
+            before a new file is created. The value must be between 1KB to
+            10GB. If the unit is omitted, KB is assumed.
+
+         --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION
+            The maximum duration that can elapse before a new Cloud Storage
+            file is created. The value must be between 1m and 10m. Valid values
+            are strings of the form INTEGER[UNIT], where UNIT is one of "s",
+            "m", "h", and "d" for seconds, minutes, hours, and days,
+            respectively. If the unit is omitted, seconds is assumed.
+
+         --cloud-storage-output-format=OUTPUT_FORMAT; default="text"
+            The output format for data written to Cloud Storage. Values: text
+            (messages will be written as raw text, separated by a newline) or
+            avro (messages will be written as an Avro binary). OUTPUT_FORMAT
+            must be one of: text, avro.
+
+         --cloud-storage-write-metadata
+            Whether or not to write the subscription name, message_id,
+            publish_time, attributes, and ordering_key as additional fields in
+            the output. This has an effect only for subscriptions with
+            --cloud-storage-output-format=avro.
+
      Dead Letter Queue Options. The Cloud Pub/Sub service account associated
      with the enclosing subscription's parent project (i.e.,
      service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have

gcloud/beta/pubsub/subscriptions/update

@@ -12,7 +12,15 @@ SYNOPSIS
         [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages]
         [--update-labels=[KEY=VALUE,...]]
         [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE
-          : --drop-unknown-fields --use-topic-schema --write-metadata]]
+          : --drop-unknown-fields --use-topic-schema --write-metadata]
+          | --clear-cloud-storage-config
+          | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET
+          : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX
+          --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX
+          --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES
+          --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION
+          --cloud-storage-output-format=OUTPUT_FORMAT;
+          default="text" --cloud-storage-write-metadata]]
         [--clear-dead-letter-policy
           | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS
           [--dead-letter-topic=DEAD_LETTER_TOPIC
@@ -138,6 +146,58 @@ FLAGS
               Whether or not to write message metadata including message ID,
               publish timestamp, ordering key, and attributes to BigQuery.
 
+       At most one of these can be specified:
+
+         --clear-cloud-storage-config
+            If set, clear the Cloud Storage config from the subscription.
+
+         Cloud Storage Config Options. The Cloud Pub/Sub service account
+         associated with the enclosing subscription's parent project (i.e.,
+         service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+         have permission to write to this Cloud Storage bucket and to read this
+         bucket's metadata.
+
+         Note that an update to the Cloud Storage config will replace it with a
+         new config containing only the flags that are passed in the update
+         CLI.
+
+           --cloud-storage-bucket=CLOUD_STORAGE_BUCKET
+              A Cloud Storage bucket to which to write messages for this
+              subscription.
+
+              This flag argument must be specified if any of the other
+              arguments in this group are specified.
+
+           --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX
+              The prefix for Cloud Storage filename.
+
+           --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX
+              The suffix for Cloud Storage filename.
+
+           --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES
+              The maximum bytes that can be written to a Cloud Storage file
+              before a new file is created. The value must be between 1KB to
+              10GB. If the unit is omitted, KB is assumed.
+
+           --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION
+              The maximum duration that can elapse before a new Cloud Storage
+              file is created. The value must be between 1m and 10m. Valid
+              values are strings of the form INTEGER[UNIT], where UNIT is one
+              of "s", "m", "h", and "d" for seconds, minutes, hours, and days,
+              respectively. If the unit is omitted, seconds is assumed.
+
+           --cloud-storage-output-format=OUTPUT_FORMAT; default="text"
+              The output format for data written to Cloud Storage. Values: text
+              (messages will be written as raw text, separated by a newline) or
+              avro (messages will be written as an Avro binary). OUTPUT_FORMAT
+              must be one of: text, avro.
+
+           --cloud-storage-write-metadata
+              Whether or not to write the subscription name, message_id,
+              publish_time, attributes, and ordering_key as additional fields
+              in the output. This has an effect only for subscriptions with
+              --cloud-storage-output-format=avro.
+
      At most one of these can be specified:
 
        --clear-dead-letter-policy