gcloud: Wed Mar 1 10:23:17 UTC 2023

gcloud/alpha/logging/buckets/create

@@ -2,7 +2,7 @@ NAME
     gcloud alpha logging buckets create - create a bucket
 
 SYNOPSIS
-    gcloud alpha logging buckets create BUCKET_ID --location=LOCATION
+    gcloud alpha logging buckets create BUCKET_ID --location=LOCATION [--async]
         [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION]
         [--enable-analytics] [--index=[KEY=VALUE, ...,...]]
         [--restricted-fields=[RESTRICTED_FIELD,...]]
@@ -38,6 +38,11 @@ EXAMPLES
         $ gcloud alpha logging buckets create my-bucket \
             --location=us-central1 --cmek-kms-key-name=CMEK_KMS_KEY_NAME
 
+    To asynchronously create a bucket enrolled into Log Analytics, run:
+
+        $ gcloud alpha logging buckets create my-bucket --location=global \
+            --async --enable-analytics
+
 POSITIONAL ARGUMENTS
      BUCKET_ID
         ID of the bucket to create.
@@ -48,6 +53,10 @@ REQUIRED FLAGS
         location cannot be changed.
 
 OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
      --cmek-kms-key-name=CMEK_KMS_KEY_NAME
         A valid kms_key_name will enable CMEK for the bucket.
 
@@ -55,8 +64,8 @@ OPTIONAL FLAGS
         A textual description for the bucket.
 
      --enable-analytics
-        Whether to opt the bucket into advanced log analytics. This field may
-        only be set at bucket creation and cannot be changed later.
+        Whether to opt the bucket into Log Analytics. Once opted in, the bucket
+        cannot be opted out of Log Analytics.
 
      --index=[KEY=VALUE, ...,...]
         Specify an index to be added to the log bucket. This flag can be