94 lines
3.3 KiB
Python
94 lines
3.3 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2018 Google LLC. All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
"""Utilities for Cloud Monitoring Policies API."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
from googlecloudsdk.api_lib.util import apis
|
|
|
|
|
|
def GetClientInstance(no_http=False):
|
|
return apis.GetClientInstance('monitoring', 'v3', no_http=no_http)
|
|
|
|
|
|
def GetMessagesModule(client=None):
|
|
client = client or GetClientInstance()
|
|
return client.MESSAGES_MODULE
|
|
|
|
|
|
class AlertPolicyClient(object):
|
|
"""Client for the Alert Policy service in the Stackdriver Monitoring API."""
|
|
|
|
def __init__(self, client=None, messages=None):
|
|
self.client = client or GetClientInstance()
|
|
self.messages = messages or GetMessagesModule(client)
|
|
self._service = self.client.projects_alertPolicies
|
|
|
|
def Create(self, project_ref, policy):
|
|
"""Creates a Stackdriver alerting policy."""
|
|
req = self.messages.MonitoringProjectsAlertPoliciesCreateRequest(
|
|
name=project_ref.RelativeName(),
|
|
alertPolicy=policy)
|
|
return self._service.Create(req)
|
|
|
|
def Get(self, policy_ref):
|
|
"""Gets an Monitoring Alert Policy."""
|
|
request = self.messages.MonitoringProjectsAlertPoliciesGetRequest(
|
|
name=policy_ref.RelativeName())
|
|
return self._service.Get(request)
|
|
|
|
def List(self, project_ref, list_filter=None):
|
|
"""List Monitoring Alert Policies.
|
|
|
|
"list_filter" must be a valid filter expression or an empty value. For more
|
|
information, see
|
|
https://cloud.google.com/monitoring/api/v3/sorting-and-filtering
|
|
|
|
Args:
|
|
project_ref: resources.Resource, Resource reference to the policy to be
|
|
updated.
|
|
list_filter: str, filter to be included in the ListAlertPOliciesRequest.
|
|
|
|
Returns:
|
|
Alert policies that match the given filter. If no filter is given, fetches
|
|
all policies from the target project.
|
|
"""
|
|
request = self.messages.MonitoringProjectsAlertPoliciesListRequest(
|
|
name=project_ref.RelativeName(), filter=list_filter or ''
|
|
)
|
|
return self._service.List(request)
|
|
|
|
def Update(self, policy_ref, policy, fields=None):
|
|
"""Updates a Monitoring Alert Policy.
|
|
|
|
If fields is not specified, then the policy is replaced entirely. If
|
|
fields are specified, then only the fields are replaced.
|
|
|
|
Args:
|
|
policy_ref: resources.Resource, Resource reference to the policy to be
|
|
updated.
|
|
policy: AlertPolicy, The policy message to be sent with the request.
|
|
fields: str, Comma separated list of field masks.
|
|
Returns:
|
|
AlertPolicy, The updated AlertPolicy.
|
|
"""
|
|
request = self.messages.MonitoringProjectsAlertPoliciesPatchRequest(
|
|
name=policy_ref.RelativeName(),
|
|
alertPolicy=policy,
|
|
updateMask=fields)
|
|
return self._service.Patch(request)
|