Creates a new alerting policy.
Design your application to single-thread API calls that modify the state of alerting policies in a single project. This includes calls to alertPolicies.create, alertPolicies.delete and alertPolicies.patch.
HTTP request
POST https://monitoring.googleapis.com/v3/{name}/alertPolicies
Path parameters
name
string
Required. The project in which to create the alerting policy. The format is:
projects/[PROJECT_ID_OR_NUMBER]
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:
-
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/monitoring
For more information, see the Authentication Overview .
