gcloud: Thu Jul 20 11:47:24 UTC 2023

gcloud/alpha/monitoring/policies/help

@@ -40,6 +40,9 @@ COMMANDS
      list
         (ALPHA) List alerting policies.
 
+     migrate
+        (ALPHA) Migrate a new alerting policy.
+
      update
         (ALPHA) Updates an alerting policy.
 

gcloud/alpha/monitoring/policies/migrate

@@ -0,0 +1,40 @@
+NAME
+    gcloud alpha monitoring policies migrate - migrate a new alerting policy
+
+SYNOPSIS
+    gcloud alpha monitoring policies migrate
+        [--channels-from-prometheus-alertmanager-yaml=PROMETHEUS_ALERT_MANAGER_FILE_PATH --policies-from-prometheus-alert-rules-yaml=[PROMETHEUS_ALERT_RULE_FILE_PATHS,
+          ...]] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Creates a new alerting policies and/or notification channels based
+    on provided Prometheus files. The rules YAML file, which holds the alert
+    rules, must be specified as a file through the
+    --policies-from-prometheus-alert-rules-yaml flag.
+
+FLAGS
+     --channels-from-prometheus-alertmanager-yaml=PROMETHEUS_ALERT_MANAGER_FILE_PATH
+        Prometheus alert manager YAML file to be converted to Cloud Monitoring
+        notification channels. Specifying this flag with the
+        --policies-from-prometheus-alert-rules-yaml flag puts the newly created
+        notification channels into the translated Alert Policies' definition.
+
+     --policies-from-prometheus-alert-rules-yaml=[PROMETHEUS_ALERT_RULE_FILE_PATHS,...]
+        One or more Prometheus alert rule YAML files (separated by commas if
+        multiple) to be converted to Cloud Alerting Policies. Example:
+        --policies-from-prometheus-alert-rules-yaml=rules_1.yaml,rules_2.yaml
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+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.
+