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

gcloud/alpha/logging/buckets/update

@@ -3,9 +3,9 @@ NAME
 
 SYNOPSIS
     gcloud alpha logging buckets update BUCKET_ID --location=LOCATION
-        [--add-index=[KEY=VALUE, ...,...]] [--clear-indexes]
+        [--add-index=[KEY=VALUE, ...,...]] [--async] [--clear-indexes]
         [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION]
-        [--enable-loglink] [--locked] [--remove-indexes=[FIELD PATH,...]]
+        [--enable-analytics] [--locked] [--remove-indexes=[FIELD PATH,...]]
         [--restricted-fields=[RESTRICTED_FIELD,...]]
         [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]]
         [GCLOUD_WIDE_FLAG ...]
@@ -44,6 +44,11 @@ EXAMPLES
         $ gcloud alpha logging buckets update my-bucket --location=global \
            --cmek-kms-key-name=CMEK_KEY_NAME
 
+    To asynchronously enroll a bucket in your project into Log Analytics, run:
+
+        $ gcloud alpha logging buckets update my-bucket --location=global \
+           --async --enable-analytics
+
 POSITIONAL ARGUMENTS
      BUCKET_ID
         The id of the bucket to update.
@@ -69,6 +74,10 @@ OPTIONAL FLAGS
             The type of data in this index. For example: INDEX_TYPE_STRING
             Supported types are strings and integers.
 
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
      --clear-indexes
         Remove all logging indexes from the bucket.
 
@@ -78,12 +87,9 @@ OPTIONAL FLAGS
      --description=DESCRIPTION
         A new description for the bucket.
 
-     --enable-loglink
-        Enables a linked dataset in BigQuery corresponding to this log bucket.
-        The linked dataset contains authorized views which give a ready-only
-        access to logs in BigQuery. This option can only be enabled in a log
-        bucket with advanced log analytics enabled. Use --no-enable-loglink to
-        disable the linked dataset.
+     --enable-analytics
+        Whether to opt the bucket into Log Analytics. Once opted in, the bucket
+        cannot be opted out of Log Analytics.
 
      --locked
         Lock the bucket and prevent it from being modified or deleted (unless