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

gcloud/compute/security-policies/create

@@ -13,6 +13,17 @@ DESCRIPTION
     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 compute security-policies create my-policy \
+            --type=CLOUD_ARMOR_EDGE --description="policy description"
+
+    To create a security from an input file, run:
+
+        $ gcloud compute security-policies create my-policy \
+            --file-name=my-file-name
+
 POSITIONAL ARGUMENTS
      NAME
         Name of the security policy to create.

gcloud/compute/security-policies/delete

@@ -10,6 +10,11 @@ DESCRIPTION
     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 compute security-policies delete my-policy
+
 POSITIONAL ARGUMENTS
      NAME [NAME ...]
         Names of the security policies to delete.

gcloud/compute/security-policies/describe

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

gcloud/compute/security-policies/export

@@ -1,13 +1,20 @@
 NAME
     gcloud compute security-policies export - export security policy configs
-        into yaml files
+        into YAML or JSON files
 
 SYNOPSIS
     gcloud compute security-policies export NAME --file-name=FILE_NAME
         [--file-format=FILE_FORMAT] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    Export security policy configs into yaml files.
+    gcloud 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 compute security-policies export my-policy \
+            --file-name=my-file-name --file-format=json
 
 POSITIONAL ARGUMENTS
      NAME

gcloud/compute/security-policies/help

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

gcloud/compute/security-policies/rules/create

@@ -24,14 +24,12 @@ DESCRIPTION
     gcloud 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 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
@@ -55,10 +53,6 @@ REQUIRED FLAGS
          deny-502
             Denies the request from HTTP(S) Load Balancing, with an HTTP
             response status code of 503.
-         fairshare
-            When traffic reaches the threshold limit, requests from the clients
-            matching this rule begin to be rate-limited using the Fair Share
-            algorithm.
          rate-based-ban
             Enforces rate-based ban action from HTTP(S) Load Balancing, based
             on rate limit options.

gcloud/compute/security-policies/rules/delete

@@ -10,6 +10,12 @@ DESCRIPTION
     gcloud compute security-policies rules delete is used to delete security
     policy rules.
 
+EXAMPLES
+    To delete the rule at priority 1000, run:
+
+        $ gcloud 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/compute/security-policies/rules/describe

@@ -10,6 +10,12 @@ DESCRIPTION
     gcloud compute security-policies rules describe displays all data
     associated with a security policy rule.
 
+EXAMPLES
+    To describe the rule at priority 1000, run:
+
+        $ gcloud 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/compute/security-policies/rules/update

@@ -25,13 +25,12 @@ DESCRIPTION
     gcloud 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 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
@@ -55,10 +54,6 @@ FLAGS
          deny-502
             Denies the request from HTTP(S) Load Balancing, with an HTTP
             response status code of 503.
-         fairshare
-            When traffic reaches the threshold limit, requests from the clients
-            matching this rule begin to be rate-limited using the Fair Share
-            algorithm.
          rate-based-ban
             Enforces rate-based ban action from HTTP(S) Load Balancing, based
             on rate limit options.