gcloud: Wed Apr 12 10:43:12 UTC 2023

gcloud/alpha/scc/custom-modules/sha/test

@@ -14,74 +14,54 @@ DESCRIPTION
     (ALPHA) Test a Security Health Analytics custom module.
 
 EXAMPLES
-    To test a Security Health Analytics custom module with id 123456 for
+    To test a Security Health Analytics custom module with ID 123456 for
     organization 123, run:
 
         $ gcloud alpha scc custom-modules sha test 123456 \
             --organization=organizations/123 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test 123456 \
-            --organization=123 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test \
-            organizations/123/securityHealthAnalyticsSettings/\
-        customModules/123456 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
+            --display-name="test_display_name" \
+            --custom-config-from-file=/tmp/custom_config.yaml \
+            --test-data-from-file=/tmp/test_data.yaml
 
-    To test a Security Health Analytics custom module with id 123456 for folder
+    To test a Security Health Analytics custom module with ID 123456 for folder
     456, run:
 
         $ gcloud alpha scc custom-modules sha test 123456 \
-            --folder=folders/456 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test 123456 --folder=456 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test \
-            folders/456/securityHealthAnalyticsSettings/customModules/\
-        123456 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
+            --folder=folders/456 --display-name="test_display_name" \
+            --custom-config-from-file=/tmp/custom_config.yaml \
+            --test-data-from-file=/tmp/test_data.yaml
 
-    To test a Security Health Analytics custom module with id 123456 for
+    To test a Security Health Analytics custom module with ID 123456 for
     project 789, run:
 
         $ gcloud alpha scc custom-modules sha test 123456 \
-            --project=projects/789 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test 123456 --project=789 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
-        $ gcloud alpha scc custom-modules sha test \
-            projects/789/securityHealthAnalyticsSettings/customModules/\
-        123456 \
-            --display-name="test_display_name"--custom-config-from-file=/\
-        tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml
+            --project=projects/789 --display-name="test_display_name" \
+            --custom-config-from-file=/tmp/custom_config.yaml \
+            --test-data-from-file=/tmp/test_data.yaml
 
 POSITIONAL ARGUMENTS
      CUSTOM_MODULE
-        Id or the full resource name of the Security Health Analytics custom
-        module.
+        ID or the full resource name of the Security Health Analytics custom
+        module. If you specify the full resource name, you do not need to
+        specify the --organization, --folder, or --project flags.
 
 REQUIRED FLAGS
      --test-data-from-file=TEST_DATA_FROM_FILE
-        Path to a YAML file containing the resource data to test the Security
-        Health Analytics custom module against.
+        Path to a YAML file that contains the resource data to test the
+        Security Health Analytics custom module against.
 
 OPTIONAL FLAGS
      --custom-config-from-file=CUSTOM_CONFIG_FROM_FILE
-        Path to a YAML file containing the custom configuration for the
-        Security Health Analytics custom module. If not specified, the existing
-        module with the given ID or resource name is used.
+        Path to a YAML file that contains the configuration for the Security
+        Health Analytics custom module. If not specified, the existing module
+        with the given ID or resource name is used.
 
      --display-name=DISPLAY_NAME
-        Display name of the Security Health Analytics custom module. Display
-        name must be at most 64 characters. Only relevant when
+        Sets the display name of the Security Health Analytics custom module.
+        This display name becomes the finding category for all findings that
+        are returned by this the custom module. The display name must be
+        between 1 and 128 characters, start with a lowercase letter, and
+        contain alphanumeric characters or underscores only. Only relevant when
         --custom-config-from-file is also specified.
 
      At most one of these can be specified:
@@ -95,8 +75,8 @@ OPTIONAL FLAGS
           resides. Formatted as organizations/123 or just 123.
 
        --project=PROJECT
-          Project (id or number) where the Security Health Analytics custom
-          module resides. Formatted as projects/789 or just 789.
+          ID or number of the project where the Security Health Analytics
+          custom module resides. Formatted as projects/789 or just 789.
 
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,