Fix up logging docs URLs after 'v2beta1' -> 'v2' transition.

Follow-on to googleapis#2625.

Author: tseaver

logging/google/cloud/logging/_gax.py

@@ -171,7 +171,7 @@ def sink_create(self, project, sink_name, filter_, destination):
         """API call:  create a sink resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create
 
         :type project: str
         :param project: ID of the project in which to create the sink.
@@ -318,7 +318,7 @@ def metric_create(self, project, metric_name, filter_, description):
         """API call:  create a metric resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/create
 
         :type project: str
         :param project: ID of the project in which to create the metric.

logging/google/cloud/logging/client.py

@@ -95,8 +95,8 @@ def logging_api(self):
         """Helper for logging-related API calls.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs
         """
         if self._logging_api is None:
             if self._use_gax:
@@ -111,7 +111,7 @@ def sinks_api(self):
         """Helper for log sink-related API calls.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks
         """
         if self._sinks_api is None:
             if _USE_GAX:
@@ -126,7 +126,7 @@ def metrics_api(self):
         """Helper for log metric-related API calls.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics
         """
         if self._metrics_api is None:
             if _USE_GAX:
@@ -177,7 +177,7 @@ def list_entries(self, projects=None, filter_=None, order_by=None,
         """Return a page of log entries.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/list
 
         :type projects: list of strings
         :param projects: project IDs to include. If not passed,
@@ -244,7 +244,7 @@ def list_sinks(self, page_size=None, page_token=None):
         """List sinks for the project associated with this client.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/list
 
         :type page_size: int
         :param page_size: maximum number of sinks to return, If not passed,
@@ -293,7 +293,7 @@ def list_metrics(self, page_size=None, page_token=None):
         """List metrics for the project associated with this client.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/list
 
         :type page_size: int
         :param page_size: maximum number of metrics to return, If not passed,

logging/google/cloud/logging/connection.py

@@ -52,8 +52,8 @@ class _LoggingAPI(object):
     """Helper mapping logging-related APIs.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/entries
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs
 
     :type connection: :class:`google.cloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
@@ -66,7 +66,7 @@ def list_entries(self, projects, filter_=None, order_by=None,
         """Return a page of log entry resources.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/list
 
         :type projects: list of strings
         :param projects: project IDs to include. If not passed,
@@ -118,7 +118,7 @@ def write_entries(self, entries, logger_name=None, resource=None,
         """API call:  log an entry resource via a POST request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/write
 
         :type entries: sequence of mapping
         :param entries: the log entry resources to log.
@@ -153,7 +153,7 @@ def logger_delete(self, project, logger_name):
         """API call:  delete all entries in a logger via a DELETE request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs/delete
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs/delete
 
         :type project: str
         :param project: ID of project containing the log entries to delete
@@ -169,7 +169,7 @@ class _SinksAPI(object):
     """Helper mapping sink-related APIs.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks
 
     :type connection: :class:`google.cloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
@@ -181,7 +181,7 @@ def list_sinks(self, project, page_size=None, page_token=None):
         """List sinks for the project associated with this client.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/list
 
         :type project: str
         :param project: ID of the project whose sinks are to be listed.
@@ -218,7 +218,7 @@ def sink_create(self, project, sink_name, filter_, destination):
         """API call:  create a sink resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create
 
         :type project: str
         :param project: ID of the project in which to create the sink.
@@ -246,7 +246,7 @@ def sink_get(self, project, sink_name):
         """API call:  retrieve a sink resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/get
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/get
 
         :type project: str
         :param project: ID of the project containing the sink.
@@ -264,7 +264,7 @@ def sink_update(self, project, sink_name, filter_, destination):
         """API call:  update a sink resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/update
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/update
 
         :type project: str
         :param project: ID of the project containing the sink.
@@ -292,7 +292,7 @@ def sink_delete(self, project, sink_name):
         """API call:  delete a sink resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/delete
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/delete
 
         :type project: str
         :param project: ID of the project containing the sink.
@@ -308,7 +308,7 @@ class _MetricsAPI(object):
     """Helper mapping sink-related APIs.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics
 
     :type connection: :class:`google.cloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
@@ -320,7 +320,7 @@ def list_metrics(self, project, page_size=None, page_token=None):
         """List metrics for the project associated with this client.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/list
 
         :type project: str
         :param project: ID of the project whose metrics are to be listed.
@@ -357,7 +357,7 @@ def metric_create(self, project, metric_name, filter_, description=None):
         """API call:  create a metric resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/create
 
         :type project: str
         :param project: ID of the project in which to create the metric.
@@ -384,7 +384,7 @@ def metric_get(self, project, metric_name):
         """API call:  retrieve a metric resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/get
 
         :type project: str
         :param project: ID of the project containing the metric.
@@ -402,7 +402,7 @@ def metric_update(self, project, metric_name, filter_, description):
         """API call:  update a metric resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/update
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/update
 
         :type project: str
         :param project: ID of the project containing the metric.
@@ -429,7 +429,7 @@ def metric_delete(self, project, metric_name):
         """API call:  delete a metric resource.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/delete
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/delete
 
         :type project: str
         :param project: ID of the project containing the metric.

logging/google/cloud/logging/entries.py

@@ -125,7 +125,7 @@ class TextEntry(_BaseEntry):
     """Entry created with ``textPayload``.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
+    https://cloud.google.com/logging/docs/api/reference/rest/Shared.Types/LogEntry
     """
     _PAYLOAD_KEY = 'textPayload'
 
@@ -134,7 +134,7 @@ class StructEntry(_BaseEntry):
     """Entry created with ``jsonPayload``.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
+    https://cloud.google.com/logging/docs/api/reference/rest/Shared.Types/LogEntry
     """
     _PAYLOAD_KEY = 'jsonPayload'
 
@@ -143,7 +143,7 @@ class ProtobufEntry(_BaseEntry):
     """Entry created with ``protoPayload``.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
+    https://cloud.google.com/logging/docs/api/reference/rest/Shared.Types/LogEntry
     """
     _PAYLOAD_KEY = 'protoPayload'
 

logging/google/cloud/logging/logger.py

@@ -23,7 +23,7 @@ class Logger(object):
     """Loggers represent named targets for log entries.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs
 
     :type name: str
     :param name: the name of the logger
@@ -162,7 +162,7 @@ def log_text(self, text, client=None, labels=None, insert_id=None,
         """API call:  log a text message via a POST request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/write
 
         :type text: text
         :param text: the log message.
@@ -196,7 +196,7 @@ def log_struct(self, info, client=None, labels=None, insert_id=None,
         """API call:  log a structured message via a POST request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/write
 
         :type info: dict
         :param info: the log entry information
@@ -230,7 +230,7 @@ def log_proto(self, message, client=None, labels=None, insert_id=None,
         """API call:  log a protobuf message via a POST request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/write
 
         :type message: Protobuf message
         :param message: the message to be logged
@@ -263,7 +263,7 @@ def delete(self, client=None):
         """API call:  delete all entries in a logger via a DELETE request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs/delete
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs/delete
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``
@@ -278,7 +278,7 @@ def list_entries(self, projects=None, filter_=None, order_by=None,
         """Return a page of log entries.
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/entries/list
 
         :type projects: list of strings
         :param projects: project IDs to include. If not passed,

logging/google/cloud/logging/metric.py

@@ -21,7 +21,7 @@ class Metric(object):
     """Metrics represent named filters for log entries.
 
     See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
+    https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics
 
     :type name: str
     :param name: the name of the metric
@@ -103,7 +103,7 @@ def create(self, client=None):
         """API call:  create the metric via a PUT request
 
         See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/create
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``
@@ -118,7 +118,7 @@ def exists(self, client=None):
         """API call:  test for the existence of the metric via a GET request
 
         See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/get
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``
@@ -141,7 +141,7 @@ def reload(self, client=None):
         """API call:  sync local metric configuration via a GET request
 
         See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/get
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``
@@ -157,7 +157,7 @@ def update(self, client=None):
         """API call:  update metric configuration via a PUT request
 
         See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/update
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/update
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``
@@ -172,7 +172,7 @@ def delete(self, client=None):
         """API call:  delete a metric via a DELETE request
 
         See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/delete
+        https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/delete
 
         :type client: :class:`~google.cloud.logging.client.Client` or
                       ``NoneType``