gcloud: Wed Aug 17 09:22:03 UTC 2022

gcloud/alpha/compute/security-policies/create

@@ -13,6 +13,17 @@ DESCRIPTION
     security policies. A security policy policy is a set of rules that controls
     access to various resources.
 
+EXAMPLES
+    To create a security policy with a given type and description, run:
+
+        $ gcloud alpha compute security-policies create my-policy \
+            --type=CLOUD_ARMOR_EDGE --description="policy description"
+
+    To create a security from an input file, run:
+
+        $ gcloud alpha compute security-policies create my-policy \
+            --file-name=my-file-name
+
 POSITIONAL ARGUMENTS
      NAME
         Name of the security policy to create.

gcloud/alpha/compute/security-policies/delete

@@ -10,6 +10,11 @@ DESCRIPTION
     Engine security policies. Security policies can only be deleted when no
     other resources (e.g., backend services) refer to them.
 
+EXAMPLES
+    To delete a security policy, run:
+
+        $ gcloud alpha compute security-policies delete my-policy
+
 POSITIONAL ARGUMENTS
      NAME [NAME ...]
         Names of the security policies to delete.

gcloud/alpha/compute/security-policies/describe

@@ -10,6 +10,11 @@ DESCRIPTION
     (ALPHA) gcloud alpha compute security-policies describe displays all data
     associated with Compute Engine security policy in a project.
 
+EXAMPLES
+    To describe a security policy, run:
+
+        $ gcloud alpha compute security-policies describe my-policy
+
 POSITIONAL ARGUMENTS
      NAME
         Name of the security policy to describe.

gcloud/alpha/compute/security-policies/export

@@ -1,6 +1,6 @@
 NAME
     gcloud alpha compute security-policies export - export security policy
-        configs into yaml files
+        configs into YAML or JSON files
 
 SYNOPSIS
     gcloud alpha compute security-policies export NAME --file-name=FILE_NAME
@@ -8,7 +8,14 @@ SYNOPSIS
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Export security policy configs into yaml files.
+    (ALPHA) gcloud alpha compute security-policies export exports all data
+    associated with Compute Engine security policy into a local file.
+
+EXAMPLES
+    To export a security policy in JSON format to a given file, run:
+
+        $ gcloud alpha compute security-policies export my-policy \
+            --file-name=my-file-name --file-format=json
 
 POSITIONAL ARGUMENTS
      NAME

gcloud/alpha/compute/security-policies/help

@@ -43,7 +43,7 @@ COMMANDS
         (ALPHA) Describe a Compute Engine security policy.
 
      export
-        (ALPHA) Export security policy configs into yaml files.
+        (ALPHA) Export security policy configs into YAML or JSON files.
 
      import
         (ALPHA) Import security policy configs into your project.

gcloud/alpha/compute/security-policies/rules/create

@@ -27,14 +27,12 @@ DESCRIPTION
     (ALPHA) gcloud alpha compute security-policies rules create is used to
     create security policy rules.
 
-    For example to create a rule at priority 1000 to block the IP range
-    1.2.3.0/24, run:
+EXAMPLES
+    To create a rule at priority 1000 to block the IP range 1.2.3.0/24, run:
 
         $ gcloud alpha compute security-policies rules create 1000 \
-            --action deny-403 \
-            --security-policy my-policy \
-            --description "block 1.2.3.0/24" \
-            --src-ip-ranges 1.2.3.0/24
+            --action=deny-403 --security-policy=my-policy \
+            --description="block 1.2.3.0/24" --src-ip-ranges=1.2.3.0/24
 
 POSITIONAL ARGUMENTS
      PRIORITY

gcloud/alpha/compute/security-policies/rules/delete

@@ -10,6 +10,12 @@ DESCRIPTION
     (ALPHA) gcloud alpha compute security-policies rules delete is used to
     delete security policy rules.
 
+EXAMPLES
+    To delete the rule at priority 1000, run:
+
+        $ gcloud alpha compute security-policies rules delete 1000 \
+            --security-policy=my-policy
+
 POSITIONAL ARGUMENTS
      [PRIORITY ...]
         The priority of the rules to delete. Rules are evaluated in order from

gcloud/alpha/compute/security-policies/rules/describe

@@ -10,6 +10,12 @@ DESCRIPTION
     (ALPHA) gcloud alpha compute security-policies rules describe displays all
     data associated with a security policy rule.
 
+EXAMPLES
+    To describe the rule at priority 1000, run:
+
+        $ gcloud alpha compute security-policies rules describe 1000 \
+            --security-policy=my-policy
+
 POSITIONAL ARGUMENTS
      PRIORITY
         The priority of the rule to describe. Rules are evaluated in order from

gcloud/alpha/compute/security-policies/rules/update

@@ -27,13 +27,12 @@ DESCRIPTION
     (ALPHA) gcloud alpha compute security-policies rules update is used to
     update security policy rules.
 
-    For example to update the description and IP ranges of a rule at priority
-    1000, run:
+EXAMPLES
+    To update the description and IP ranges of a rule at priority 1000, run:
 
         $ gcloud alpha compute security-policies rules update 1000 \
-            --security-policy my-policy \
-            --description "block 1.2.3.4/32" \
-            --src-ip-ranges 1.2.3.4/32
+            --security-policy=my-policy --description="block 1.2.3.4/32" \
+            --src-ip-ranges=1.2.3.4/32
 
 POSITIONAL ARGUMENTS
      PRIORITY