gcloud: Wed Dec 6 10:10:36 UTC 2023

gcloud/alpha/recommender/insights/list

@@ -2,16 +2,18 @@ NAME
     gcloud alpha recommender insights list - list insights for a cloud entity
 
 SYNOPSIS
-    gcloud alpha recommender insights list --location=LOCATION
+    gcloud alpha recommender insights list
         (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
           | --organization=ORGANIZATION_ID | --project=PROJECT_ID)
-        [--insight-type=INSIGHT_TYPE] [--filter=EXPRESSION] [--limit=LIMIT]
-        [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
-        [GCLOUD_WIDE_FLAG ...]
+        [--insight-type=INSIGHT_TYPE] [--location=LOCATION]
+        [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
+        [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) This command lists all insights for a given cloud entity, location
-    and insight type. Supported insight-types can be found here:
+    and insight type. If insight-type or location is not specified, insights
+    for all supported insight-types and locations are listed. Supported
+    insight-types can be found here:
     https://cloud.google.com/recommender/docs/insights/insight-types. Currently
     the following cloud_entity_types are supported: project, billing_account,
     folder and organization.
@@ -19,13 +21,10 @@ DESCRIPTION
 EXAMPLES
     To list all insights for a billing account:
 
-        $ gcloud alpha recommender insights list --project=project-name \
+        $ gcloud alpha recommender insights list --project=project-id \
             --location=global --insight-type=google.compute.firewall.Insight
 
 REQUIRED FLAGS
-     --location=LOCATION
-        Location
-
      Resource that is associated with cloud entity type. Currently four
      mutually exclusive flags are supported, --project, --billing-account,
      --folder, --organization.
@@ -51,6 +50,10 @@ FLAGS
         Insight type to list insights for. Supported insight-types can be found
         here: https://cloud.google.com/recommender/docs/insights/insight-types
 
+     --location=LOCATION
+        Location to list insights for. If no location is specified, insights
+        for all supported locations are listed.
+
 LIST COMMAND FLAGS
      --filter=EXPRESSION
         Apply a Boolean filter EXPRESSION to each resource item to be listed.

gcloud/alpha/recommender/insights/mark-accepted

@@ -18,7 +18,7 @@ EXAMPLES
     To mark an insight as ACCEPTED:
 
         $ gcloud alpha recommender insights mark-accepted abcd-1234 \
-            --project=project-name --location=global \
+            --project=project-id --location=global \
             --insight-type=google.compute.firewall.Insight --etag=abc123
 
 POSITIONAL ARGUMENTS

gcloud/alpha/recommender/insights/mark-active

@@ -18,7 +18,7 @@ EXAMPLES
     To mark an insight as ACTIVE:
 
         $ gcloud alpha recommender insights mark-active abcd-1234 \
-            --project=project-name --location=global \
+            --project=project-id --location=global \
             --insight-type=google.compute.firewall.Insight --etag=abc123
 
 POSITIONAL ARGUMENTS

gcloud/alpha/recommender/insights/mark-dismissed

@@ -19,7 +19,7 @@ EXAMPLES
     To mark an insight as DISMISSED:
 
         $ gcloud alpha recommender insights mark-dismissed abcd-1234 \
-            --project=project-name --location=global \
+            --project=project-id --location=global \
             --insight-type=google.compute.firewall.Insight --etag=abc123
 
 POSITIONAL ARGUMENTS

gcloud/alpha/recommender/recommendations/list

@@ -3,29 +3,28 @@ NAME
         recommendation
 
 SYNOPSIS
-    gcloud alpha recommender recommendations list --location=LOCATION
+    gcloud alpha recommender recommendations list
         (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
           | --organization=ORGANIZATION_ID | --project=PROJECT_ID)
-        [--recommender=RECOMMENDER] [--filter=EXPRESSION] [--limit=LIMIT]
-        [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
+        [--location=LOCATION] [--recommender=RECOMMENDER] [--filter=EXPRESSION]
+        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) This command lists all recommendations for a given cloud_entity_id,
-    location and recommender. Supported recommenders can be found here:
+    location, and recommender. If recommender or location is not specified,
+    recommendations for all supported recommenders and locations are listed.
+    Supported recommenders can be found here:
     https://cloud.google.com/recommender/docs/recommenders. Currently the
     following cloud_entity_types are supported: project, billing_account,
     folder and organization.
 
 EXAMPLES
     Lists recommendations for a Cloud project.        $ gcloud alpha recommender recommendations list \
-            --project=project-name --location=global \
+            --project=project-id --location=global \
             --recommender=google.compute.instance.MachineTypeRecommender
 
 REQUIRED FLAGS
-     --location=LOCATION
-        Location
-
      Resource that is associated with cloud entity type. Currently four
      mutually exclusive flags are supported, --project, --billing-account,
      --folder, --organization.
@@ -47,9 +46,13 @@ REQUIRED FLAGS
           core/project property value for this command invocation.
 
 FLAGS
+     --location=LOCATION
+        Location to list recommendations for. If no location is specified,
+        recommendations for all supported locations are listed.
+
      --recommender=RECOMMENDER
         Recommender to list recommendations for. If no recommender is
-        specified, recommendations for all supported recommenders is listed.
+        specified, recommendations for all supported recommenders are listed.
         Supported recommenders can be found here:
         https://cloud.google.com/recommender/docs/recommenders
 

gcloud/alpha/recommender/recommendations/mark-claimed

@@ -19,8 +19,8 @@ DESCRIPTION
 EXAMPLES
     To mark a recommendation as CLAIMED:
 
-        $ gcloud alpha recommender recommendations mark-claimed \
-            RECOMMENDATION --project=project-name --location=global \
+        $ gcloud alpha recommender recommendations mark-claimed abcd-1234 \
+            --project=project-id --location=global \
             --recommender=google.compute.instance.MachineTypeRecommender \
             --etag=abc123 --state-metadata=key1=value1,key2=value2
 

gcloud/alpha/recommender/recommendations/mark-dismissed

@@ -19,7 +19,7 @@ EXAMPLES
     To mark a recommendation as DISMISSED:
 
         $ gcloud alpha recommender recommendations mark-dismissed \
-            abcd-1234 --project=project-name --location=global \
+            abcd-1234 --project=project-id --location=global \
             --recommender=google.compute.instance.MachineTypeRecommender \
             --etag=abc123
 

gcloud/alpha/recommender/recommendations/mark-failed

@@ -17,7 +17,7 @@ EXAMPLES
     To mark a recommendation as FAILED:
 
         $ gcloud alpha recommender recommendations mark-failed abcd-1234 \
-            --project=project-name --location=global \
+            --project=project-id --location=global \
             --recommender=google.compute.instance.MachineTypeRecommender \
             --etag=abc123 --state-metadata=key1=value1,key2=value2
 

gcloud/alpha/recommender/recommendations/mark-succeeded

@@ -17,7 +17,7 @@ EXAMPLES
     To mark a recommendation as SUCCEEDED:
 
         $ gcloud alpha recommender recommendations mark-succeeded \
-            abcd-1234 --project=project-name --location=global \
+            abcd-1234 --project=project-id --location=global \
             --recommender=google.compute.instance.MachineTypeRecommender \
             --etag=abc123 --state-metadata=key1=value1,key2=value2