Method: projects.alertPolicies.create

Creates a new alerting policy.

HTTP request


Path parameters



Required. The project in which to create the alerting policy. The format is:


Note that this field names the parent container in which the alerting policy will be written, not the name of the created policy. |name| must be a host project of a Metrics Scope, otherwise INVALID_ARGUMENT error will return. The alerting policy that is returned will have a name that contains a normalized representation of this name as a prefix but adds a suffix of the form /alertPolicies/[ALERT_POLICY_ID], identifying the policy in the container.

Authorization requires the following IAM permission on the specified resource name:

  • monitoring.alertPolicies.create

Request body

The request body contains an instance of AlertPolicy.

Response body

If successful, the response body contains a newly created instance of AlertPolicy.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.