gcloud: Wed May 18 08:41:01 UTC 2022

gcloud/alpha/active-directory/domains/backups/create

@@ -1,6 +1,6 @@
 NAME
     gcloud alpha active-directory domains backups create - create a Managed
-        Microsoft Active Directory domain backup
+        Microsoft AD domain backup
 
 SYNOPSIS
     gcloud alpha active-directory domains backups create
@@ -8,21 +8,21 @@ SYNOPSIS
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Create a new Managed Microsoft AD domain backup with the given name
-    using Google Cloud's Managed Service for Microsoft Active Directory.
+    (ALPHA) Create a new Managed Microsoft AD domain backup with the specified
+    name using Google Cloud's Managed Service for Microsoft Active Directory.
 
     This command can fail for the following reasons:
-      ▪ The domain specified does not exist.
-      ▪ The domain specified is being created.
+      ▪ The specified domain doesn't exist.
+      ▪ The specified domain is being created.
       ▪ A backup already exists with the same target domain name.
-      ▪ The active account does not have permission to access the given
+      ▪ The active account doesn't have permission to access the specified
         domain.
-      ▪ The active account does not have permission to create AD domain
+      ▪ The active account doesn't have permission to create AD domain
         backups.
 
 EXAMPLES
-    The following command creates an Active Directory domain backup named
-    my-backup under domain my-domain.com
+    To create an AD domain backup named my-backup under domain my-domain.com,
+    run:
 
         $ gcloud alpha active-directory domains backups create my-backup \
             --domain=my-domain.com --project=my-proj --async
@@ -80,7 +80,9 @@ NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups create
 
         $ gcloud beta active-directory domains backups create
 

gcloud/alpha/active-directory/domains/backups/delete

@@ -1,24 +1,24 @@
 NAME
     gcloud alpha active-directory domains backups delete - delete a Managed
-        Microsoft Active Directory domain backup
+        Microsoft AD domain backup
 
 SYNOPSIS
     gcloud alpha active-directory domains backups delete
         (BACKUP : --domain=DOMAIN) [--async] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Delete a Managed Microsoft AD domain backup with the given name
+    (ALPHA) Delete a Managed Microsoft AD domain backup with the specified name
     using Google Cloud's Managed Service for Microsoft Active Directory.
 
     This command can fail for the following reasons:
-      ▪ TThe backup specified does not exist.
-      ▪ The active account does not have permission to access the given
+      ▪ The specified backup doesn't exist.
+      ▪ The active account doesn't have permission to access the specified
         domain.
-      ▪ The active account does not have permission to access the given AD
-        backup.
+      ▪ The active account doesn't have permission to access the specified AD
+        domain backup.
 
 EXAMPLES
-    The following command deletes an AD domain backup my-backup under domain        projects/my-proj/locations/global/domains/my-domain.com
+    To delete an AD domain backup my-backup under domain        `projects/my-proj/locations/global/domains/my-domain.com`, run:
 
         $ gcloud alpha active-directory domains backups delete \
             projects/my-proj/locations/global/domains/my-domain.com/\
@@ -74,7 +74,9 @@ NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups delete
 
         $ gcloud beta active-directory domains backups delete
 

gcloud/alpha/active-directory/domains/backups/describe

@@ -1,6 +1,6 @@
 NAME
     gcloud alpha active-directory domains backups describe - describe a Managed
-        Microsoft Active Directory domain backup
+        Microsoft AD domain backup
 
 SYNOPSIS
     gcloud alpha active-directory domains backups describe
@@ -9,17 +9,17 @@ SYNOPSIS
 DESCRIPTION
     (ALPHA) Show metadata for a Managed Microsoft AD domain backup.
 
-    Displays all metadata associated with a Active Directory domain backup
-    given a valid domain backup name.
+    Displays all metadata associated with an Active Directory domain backup
+    when provided with a valid domain backup name.
 
     This command can fail for the following reasons:
-      ▪ The specified domain backup does not exist.
-      ▪ The active account does not have permission to access the given
+      ▪ The specified domain backup doesn't exist.
+      ▪ The active account doesn't have permission to access the specified
         domain.
 
 EXAMPLES
-    The following command gets metadata for an AD domain backup with the name
-    my-backup under the domain my-domain in project my-project.
+    To display all metadata associated with an AD domain backup with the name
+    my-backup under the domain my-domain in project my-project, run:
 
         $ gcloud alpha active-directory domains backups describe \
             projects/my-proj/locations/global/domains/my-domain.com/\
@@ -70,7 +70,9 @@ NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups describe
 
         $ gcloud beta active-directory domains backups describe
 

gcloud/alpha/active-directory/domains/backups/help

@@ -18,25 +18,27 @@ COMMANDS
     COMMAND is one of the following:
 
      create
-        (ALPHA) Create a Managed Microsoft Active Directory domain backup.
+        (ALPHA) Create a Managed Microsoft AD domain backup.
 
      delete
-        (ALPHA) Delete a Managed Microsoft Active Directory domain backup.
+        (ALPHA) Delete a Managed Microsoft AD domain backup.
 
      describe
-        (ALPHA) Describe a Managed Microsoft Active Directory domain backup.
+        (ALPHA) Describe a Managed Microsoft AD domain backup.
 
      list
-        (ALPHA) List all Managed Microsoft Active Directory domain backups.
+        (ALPHA) List all Managed Microsoft AD domain backups.
 
      update
-        (ALPHA) Update a managed Microsoft Active Directory domain backup.
+        (ALPHA) Update a Managed Microsoft AD domain backup.
 
 NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups
 
         $ gcloud beta active-directory domains backups
 

gcloud/alpha/active-directory/domains/backups/list

@@ -1,6 +1,6 @@
 NAME
     gcloud alpha active-directory domains backups list - list all Managed
-        Microsoft Active Directory domain backups
+        Microsoft AD domain backups
 
 SYNOPSIS
     gcloud alpha active-directory domains backups list --domain=DOMAIN
@@ -8,27 +8,27 @@ SYNOPSIS
         [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) List all Managed Microsoft AD domain backups in the given Managed
-    Microsoft AD domain.
+    (ALPHA) List all Managed Microsoft AD domain backups in the specified
+    Managed Microsoft AD domain.
 
     Displays associated Active Directory domain backups.
 
     This command can fail for the following reasons:
-      ▪ The active account does not have permission to access the given
+      ▪ The active account doesn't have permission to access the specified
         domain.
 
 EXAMPLES
-    The following command lists all an AD domain backups in the project
-    my-project and domain my-domain.com.
+    To list all AD domain backups in the project my-project under domain
+    my-domain.com, run:
 
         $ gcloud alpha active-directory domains backups list \
             --project=my-project --domain=my-domain.com --limit=5
 
 REQUIRED FLAGS
-     Domain resource - Name of the domain under which you want to list all
-     Managed Microsoft AD domain backups. This represents a Cloud resource.
-     (NOTE) Some attributes are not given arguments in this group but can be
-     set in other ways. To set the project attribute:
+     Domain resource - Name of the domain for which you want to list all
+     associated Managed Microsoft AD domain backups. This represents a Cloud
+     resource. (NOTE) Some attributes are not given arguments in this group but
+     can be set in other ways. To set the project attribute:
       ◆ provide the argument --domain on the command line with a fully
         specified name;
       ◆ set the property core/project;
@@ -90,7 +90,9 @@ NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups list
 
         $ gcloud beta active-directory domains backups list
 

gcloud/alpha/active-directory/domains/backups/update

@@ -1,6 +1,6 @@
 NAME
-    gcloud alpha active-directory domains backups update - update a managed
-        Microsoft Active Directory domain backup
+    gcloud alpha active-directory domains backups update - update a Managed
+        Microsoft AD domain backup
 
 SYNOPSIS
     gcloud alpha active-directory domains backups update
@@ -8,15 +8,15 @@ SYNOPSIS
         [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Update a managed Microsoft Active Directory domain backup.
-      ▪ The backup specified does not exist.
-      ▪ The active account does not have permission to access the given
+    (ALPHA) Update a Managed Microsoft AD domain backup.
+      ▪ The specified backup doesn't exist.
+      ▪ The active account doesn't have permission to access the specified
         domain.
-      ▪ The active account does not have permission to access the given
-        backup.
+      ▪ The active account doesn't have permission to access the specified
+        domain backup.
 
 EXAMPLES
-    The following command updates an AD domain backup my-backup under domain        projects/my-proj/locations/global/domains/my-domain.com with the labels l1 and l2
+    To update an AD domain backup my-backup under domain        `projects/my-proj/locations/global/domains/my-domain.com` with the labels `l1` and `l2`, run:
 
         $ gcloud alpha active-directory domains backups update \
             projects/my-proj/locations/global/domains/my-domain.com/\
@@ -101,7 +101,9 @@ NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct
     project, you might be trying to access an API with an invitation-only early
-    access allowlist. This variant is also available:
+    access allowlist. These variants are also available:
+
+        $ gcloud active-directory domains backups update
 
         $ gcloud beta active-directory domains backups update