From 83523ca1782fa734d5328eab7c2462606f50432a Mon Sep 17 00:00:00 2001 From: daspecster Date: Wed, 22 Mar 2017 16:25:07 -0400 Subject: [PATCH] Update references that were 301 redirecting. --- docs/logging-usage.rst | 6 ++-- .../google/cloud/error_reporting/client.py | 4 +-- logging/google/cloud/logging/_gax.py | 4 +-- logging/google/cloud/logging/_http.py | 34 +++++++++---------- logging/google/cloud/logging/client.py | 14 ++++---- logging/google/cloud/logging/entries.py | 6 ++-- logging/google/cloud/logging/logger.py | 12 +++---- logging/google/cloud/logging/metric.py | 12 +++---- logging/google/cloud/logging/sink.py | 12 +++---- 9 files changed, 52 insertions(+), 52 deletions(-) diff --git a/docs/logging-usage.rst b/docs/logging-usage.rst index e25b1645f75a..410e0ead4d8d 100644 --- a/docs/logging-usage.rst +++ b/docs/logging-usage.rst @@ -175,7 +175,7 @@ Make sure that the storage bucket you want to export logs too has ``cloud-logs@google.com`` as the owner. See `Setting permissions for Cloud Storage`_. -.. _Setting permissions for Cloud Storage: https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs +.. _Setting permissions for Cloud Storage: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_to_cloud_storage Add ``cloud-logs@google.com`` as the owner of the bucket: @@ -200,7 +200,7 @@ and add ``cloud-logs@google.com`` to a dataset. See: `Setting permissions for BigQuery`_ -.. _Setting permissions for BigQuery: https://cloud.google.com/logging/docs/export/configure_export#manual-access-bq +.. _Setting permissions for BigQuery: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_to_bigquery .. literalinclude:: logging_snippets.py :start-after: [START sink_dataset_permissions] @@ -223,7 +223,7 @@ and add ``cloud-logs@google.com`` to a topic. See: `Setting permissions for Pub/Sub`_ -.. _Setting permissions for Pub/Sub: https://cloud.google.com/logging/docs/export/configure_export#manual-access-pubsub +.. _Setting permissions for Pub/Sub: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_logs_to_cloud_pubsub .. literalinclude:: logging_snippets.py :start-after: [START sink_topic_permissions] diff --git a/error_reporting/google/cloud/error_reporting/client.py b/error_reporting/google/cloud/error_reporting/client.py index 043d3faef1eb..9209dae2e641 100644 --- a/error_reporting/google/cloud/error_reporting/client.py +++ b/error_reporting/google/cloud/error_reporting/client.py @@ -143,8 +143,8 @@ def report_errors_api(self): """Helper for logging-related API calls. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/entries - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs :rtype: :class:`_gax._ErrorReportingGaxApi` diff --git a/logging/google/cloud/logging/_gax.py b/logging/google/cloud/logging/_gax.py index 6a4ede985e42..e2f048fbd54f 100644 --- a/logging/google/cloud/logging/_gax.py +++ b/logging/google/cloud/logging/_gax.py @@ -194,7 +194,7 @@ def sink_create(self, project, sink_name, filter_, destination): """API call: create a sink resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create :type project: str :param project: ID of the project in which to create the sink. @@ -343,7 +343,7 @@ def metric_create(self, project, metric_name, filter_, description): """API call: create a metric resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/create + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create :type project: str :param project: ID of the project in which to create the metric. diff --git a/logging/google/cloud/logging/_http.py b/logging/google/cloud/logging/_http.py index 2764736b1e39..d9e7e4dacacd 100644 --- a/logging/google/cloud/logging/_http.py +++ b/logging/google/cloud/logging/_http.py @@ -53,8 +53,8 @@ class _LoggingAPI(object): """Helper mapping logging-related APIs. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/entries - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs :type client: :class:`~google.cloud.logging.client.Client` :param client: The client used to make API requests. @@ -69,7 +69,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/reference/rest/v2/entries/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list :type projects: list of strings :param projects: project IDs to include. If not passed, @@ -128,7 +128,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/reference/rest/v2/entries/write + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write :type entries: sequence of mapping :param entries: the log entry resources to log. @@ -162,7 +162,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/reference/rest/v2/projects.logs/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs/delete :type project: str :param project: ID of project containing the log entries to delete @@ -178,7 +178,7 @@ class _SinksAPI(object): """Helper mapping sink-related APIs. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks :type client: :class:`~google.cloud.logging.client.Client` :param client: The client used to make API requests. @@ -191,7 +191,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/reference/rest/v2/projects.sinks/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/list :type project: str :param project: ID of the project whose sinks are to be listed. @@ -225,7 +225,7 @@ def sink_create(self, project, sink_name, filter_, destination): """API call: create a sink resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create :type project: str :param project: ID of the project in which to create the sink. @@ -253,7 +253,7 @@ def sink_get(self, project, sink_name): """API call: retrieve a sink resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/get + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get :type project: str :param project: ID of the project containing the sink. @@ -271,7 +271,7 @@ def sink_update(self, project, sink_name, filter_, destination): """API call: update a sink resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/update + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/update :type project: str :param project: ID of the project containing the sink. @@ -299,7 +299,7 @@ def sink_delete(self, project, sink_name): """API call: delete a sink resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/delete :type project: str :param project: ID of the project containing the sink. @@ -315,7 +315,7 @@ class _MetricsAPI(object): """Helper mapping sink-related APIs. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics :type client: :class:`~google.cloud.logging.client.Client` :param client: The client used to make API requests. @@ -328,7 +328,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/reference/rest/v2/projects.metrics/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/list :type project: str :param project: ID of the project whose metrics are to be listed. @@ -362,7 +362,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/reference/rest/v2/projects.metrics/create + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create :type project: str :param project: ID of the project in which to create the metric. @@ -389,7 +389,7 @@ def metric_get(self, project, metric_name): """API call: retrieve a metric resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/get + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/get :type project: str :param project: ID of the project containing the metric. @@ -407,7 +407,7 @@ def metric_update(self, project, metric_name, filter_, description): """API call: update a metric resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/update + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/update :type project: str :param project: ID of the project containing the metric. @@ -434,7 +434,7 @@ def metric_delete(self, project, metric_name): """API call: delete a metric resource. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/delete :type project: str :param project: ID of the project containing the metric. diff --git a/logging/google/cloud/logging/client.py b/logging/google/cloud/logging/client.py index 130db45c2855..2da6eeb38c07 100644 --- a/logging/google/cloud/logging/client.py +++ b/logging/google/cloud/logging/client.py @@ -112,8 +112,8 @@ def logging_api(self): """Helper for logging-related API calls. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/entries - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs """ if self._logging_api is None: if self._use_gax: @@ -127,7 +127,7 @@ def sinks_api(self): """Helper for log sink-related API calls. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks """ if self._sinks_api is None: if self._use_gax: @@ -141,7 +141,7 @@ def metrics_api(self): """Helper for log metric-related API calls. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.metrics + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics """ if self._metrics_api is None: if self._use_gax: @@ -166,7 +166,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/reference/rest/v2/entries/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list :type projects: list of strings :param projects: project IDs to include. If not passed, @@ -228,7 +228,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/reference/rest/v2/projects.sinks/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/list :type page_size: int :param page_size: maximum number of sinks to return, If not passed, @@ -273,7 +273,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/reference/rest/v2/projects.metrics/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/list :type page_size: int :param page_size: maximum number of metrics to return, If not passed, diff --git a/logging/google/cloud/logging/entries.py b/logging/google/cloud/logging/entries.py index 417d42cefdca..1ae5d34ec8b9 100644 --- a/logging/google/cloud/logging/entries.py +++ b/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/reference/rest/Shared.Types/LogEntry + https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry """ _PAYLOAD_KEY = 'textPayload' @@ -134,7 +134,7 @@ class StructEntry(_BaseEntry): """Entry created with ``jsonPayload``. See: - https://cloud.google.com/logging/docs/api/reference/rest/Shared.Types/LogEntry + https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry """ _PAYLOAD_KEY = 'jsonPayload' @@ -143,7 +143,7 @@ class ProtobufEntry(_BaseEntry): """Entry created with ``protoPayload``. See: - https://cloud.google.com/logging/docs/api/reference/rest/Shared.Types/LogEntry + https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry """ _PAYLOAD_KEY = 'protoPayload' diff --git a/logging/google/cloud/logging/logger.py b/logging/google/cloud/logging/logger.py index b81c27389ef4..459647bbea67 100644 --- a/logging/google/cloud/logging/logger.py +++ b/logging/google/cloud/logging/logger.py @@ -24,7 +24,7 @@ class Logger(object): """Loggers represent named targets for log entries. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.logs + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs :type name: str :param name: the name of the logger @@ -169,7 +169,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/reference/rest/v2/entries/write + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write :type text: str :param text: the log message. @@ -206,7 +206,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/reference/rest/v2/entries/write + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write :type info: dict :param info: the log entry information @@ -243,7 +243,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/reference/rest/v2/entries/write + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list :type message: Protobuf message :param message: the message to be logged @@ -279,7 +279,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/reference/rest/v2/projects.logs/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs/delete :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` @@ -294,7 +294,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/reference/rest/v2/entries/list + https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list :type projects: list of strings :param projects: project IDs to include. If not passed, diff --git a/logging/google/cloud/logging/metric.py b/logging/google/cloud/logging/metric.py index e0912583c8a9..8067fb281b23 100644 --- a/logging/google/cloud/logging/metric.py +++ b/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/reference/rest/v2/projects.metrics + https://cloud.google.com/logging/docs/reference/v2/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/reference/rest/v2/projects.metrics/create + https://cloud.google.com/logging/docs/reference/v2/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/reference/rest/v2/projects.metrics/get + https://cloud.google.com/logging/docs/reference/v2/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/reference/rest/v2/projects.metrics/get + https://cloud.google.com/logging/docs/reference/v2/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/reference/rest/v2/projects.metrics/update + https://cloud.google.com/logging/docs/reference/v2/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/reference/rest/v2/projects.metrics/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/delete :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` diff --git a/logging/google/cloud/logging/sink.py b/logging/google/cloud/logging/sink.py index aeadde05ed9a..184cf36b00e6 100644 --- a/logging/google/cloud/logging/sink.py +++ b/logging/google/cloud/logging/sink.py @@ -21,7 +21,7 @@ class Sink(object): """Sinks represent filtered exports for log entries. See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks :type name: str :param name: the name of the sink @@ -107,7 +107,7 @@ def create(self, client=None): """API call: create the sink via a PUT request See: - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` @@ -122,7 +122,7 @@ def exists(self, client=None): """API call: test for the existence of the sink via a GET request See - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/get + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` @@ -145,7 +145,7 @@ def reload(self, client=None): """API call: sync local sink configuration via a GET request See - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/get + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` @@ -161,7 +161,7 @@ def update(self, client=None): """API call: update sink configuration via a PUT request See - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/update + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/update :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType`` @@ -176,7 +176,7 @@ def delete(self, client=None): """API call: delete a sink via a DELETE request See - https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/delete + https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/delete :type client: :class:`~google.cloud.logging.client.Client` or ``NoneType``