a !f>@sVdZddlmZGdddejZGdddeZGdddeZGd d d eZ d S) z7Create / interact with Stackdriver Logging connections.) connectionc@s eZdZdZdZdZdZdZdS) Connectiona)A connection to Google Stackdriver Logging via the JSON REST API. :type credentials: :class:`oauth2client.client.OAuth2Credentials` :param credentials: (Optional) The OAuth2 Credentials to use for this connection. :type http: :class:`httplib2.Http` or class that defines ``request()``. :param http: (Optional) HTTP object to make requests. :type api_base_url: string :param api_base_url: The base of the API call URL. Defaults to the value :attr:`Connection.API_BASE_URL`. zhttps://logging.googleapis.comZv2beta1z"{api_base_url}/{api_version}{path})z,https://www.googleapis.com/auth/logging.readz-https://www.googleapis.com/auth/logging.writez-https://www.googleapis.com/auth/logging.adminz.https://www.googleapis.com/auth/cloud-platformN)__name__ __module__ __qualname____doc__Z API_BASE_URLZ API_VERSIONZAPI_URL_TEMPLATEZSCOPErrZ/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/logging/connection.pyrs rc@s4eZdZdZddZd ddZd ddZd d ZdS) _LoggingAPIa]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 :type connection: :class:`gcloud.logging.connection.Connection` :param connection: the connection used to make API requests. cCs ||_dSN _connectionselfrrrr __init__=sz_LoggingAPI.__init__NcCspd|i}|dur||d<|dur(||d<|dur8||d<|durH||d<|jjdd|d }|d d |d fS) a Return a page of log entry resources. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list :type projects: list of strings :param projects: project IDs to include. If not passed, defaults to the project bound to the client. :type filter_: str :param filter_: a filter expression. See: https://cloud.google.com/logging/docs/view/advanced_filters :type order_by: str :param order_by: One of :data:`gcloud.logging.ASCENDING` or :data:`gcloud.logging.DESCENDING`. :type page_size: int :param page_size: maximum number of entries to return, If not passed, defaults to a value set by the API. :type page_token: str :param page_token: opaque marker for the next "page" of entries. If not passed, the API will return the first page of entries. :rtype: tuple, (list, str) :returns: list of mappings, plus a "next page token" string: if not None, indicates that more entries can be retrieved with another call (pass that value as ``page_token``). Z projectIdsNfilterZorderBypageSize pageTokenPOSTz /entries:listmethodpathdataentriesr nextPageTokenr api_requestget)rZprojectsfilter_Zorder_by page_size page_tokenparamsresprrr list_entries@s!z_LoggingAPI.list_entriescCsRdt|i}|dur||d<|dur,||d<|dur<||d<|jjdd|ddS) aAPI call: log an entry resource via a POST request See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write :type entries: sequence of mapping :param entries: the log entry resources to log. :type logger_name: string :param logger_name: name of default logger to which to log the entries; individual entries may override. :type resource: mapping :param resource: default resource to associate with entries; individual entries may override. :type labels: mapping :param labels: default labels to associate with entries; individual entries may override. rNZlogNameresourcelabelsrz/entries:writer)listr r)rr logger_namer$r%rrrr write_entriests  z_LoggingAPI.write_entriescCs d||f}|jjd|ddS)aAPI 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 :type project: string :param project: ID of project containing the log entries to delete :type logger_name: string :param logger_name: name of logger containing the log entries to delete z/projects/%s/logs/%sDELETErrNr r)rprojectr'rrrr logger_deletes z_LoggingAPI.logger_delete)NNNN)NNN)rrrrrr#r(r-rrrr r 3s  4 $r c@sBeZdZdZddZdddZddZd d Zd d Zd dZ dS) _SinksAPIa Helper mapping sink-related APIs. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks :type connection: :class:`gcloud.logging.connection.Connection` :param connection: the connection used to make API requests. cCs ||_dSr r rrrr rsz_SinksAPI.__init__NcCsZi}|dur||d<|dur$||d<d|f}|jjd||d}|dd}||d fS) aList sinks for the project associated with this client. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/list :type project: string :param project: ID of the project whose sinks are to be listed. :type page_size: int :param page_size: maximum number of sinks to return, If not passed, defaults to a value set by the API. :type page_token: str :param page_token: opaque marker for the next "page" of sinks. If not passed, the API will return the first page of sinks. :rtype: tuple, (list, str) :returns: list of mappings, plus a "next page token" string: if not None, indicates that more sinks can be retrieved with another call (pass that value as ``page_token``). Nrr/projects/%s/sinksGETrrZ query_paramssinksrrr)rr,rr r!rr"r2rrr list_sinkss  z_SinksAPI.list_sinkscCs,d|f}|||d}|jjd||ddS)aAPI call: create a sink resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create :type project: string :param project: ID of the project in which to create the sink. :type sink_name: string :param sink_name: the name of the sink :type filter_: string :param filter_: the advanced logs filter expression defining the entries exported by the sink. :type destination: string :param destination: destination URI for the entries exported by the sink. r/namer destinationrrNr+rr, sink_namerr6targetrrrr sink_creates  z_SinksAPI.sink_createcCsd||f}|jjd|dS)aAPI call: retrieve a sink resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/get :type project: string :param project: ID of the project containing the sink. :type sink_name: string :param sink_name: the name of the sink :rtype: dict :returns: The JSON sink object returned from the API. /projects/%s/sinks/%sr0r*r+rr,r8r9rrr sink_gets z_SinksAPI.sink_getcCs.d||f}|||d}|jjd||ddS)awAPI call: update a sink resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/update :type project: string :param project: ID of the project containing the sink. :type sink_name: string :param sink_name: the name of the sink :type filter_: string :param filter_: the advanced logs filter expression defining the entries exported by the sink. :type destination: string :param destination: destination URI for the entries exported by the sink. r;r4PUTrNr+r7rrr sink_updates  z_SinksAPI.sink_updatecCs d||f}|jjd|ddS)aHAPI call: delete a sink resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/delete :type project: string :param project: ID of the project containing the sink. :type sink_name: string :param sink_name: the name of the sink r;r)r*Nr+r<rrr sink_delete#s z_SinksAPI.sink_delete)NN) rrrrrr3r:r=r?r@rrrr r.s %r.c@sDeZdZdZddZdddZdddZd d Zd d Zd dZ dS) _MetricsAPIaHelper mapping sink-related APIs. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics :type connection: :class:`gcloud.logging.connection.Connection` :param connection: the connection used to make API requests. cCs ||_dSr r rrrr r<sz_MetricsAPI.__init__NcCsZi}|dur||d<|dur$||d<d|f}|jjd||d}|dd}||d fS) aList metrics for the project associated with this client. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/list :type project: string :param project: ID of the project whose metrics are to be listed. :type page_size: int :param page_size: maximum number of metrics to return, If not passed, defaults to a value set by the API. :type page_token: str :param page_token: opaque marker for the next "page" of metrics. If not passed, the API will return the first page of metrics. :rtype: tuple, (list, str) :returns: list of mappings, plus a "next page token" string: if not None, indicates that more metrics can be retrieved with another call (pass that value as ``page_token``). Nrr/projects/%s/metricsr0r1metricsrrr)rr,rr r!rr"rCrrr list_metrics?s  z_MetricsAPI.list_metricscCs,d|f}|||d}|jjd||ddS)aVAPI call: create a metric resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create :type project: string :param project: ID of the project in which to create the metric. :type metric_name: string :param metric_name: the name of the metric :type filter_: string :param filter_: the advanced logs filter expression defining the entries exported by the metric. :type description: string :param description: description of the metric. rBr5r descriptionrrNr+rr, metric_namerrFr9rrrr metric_createds  z_MetricsAPI.metric_createcCsd||f}|jjd|dS)aAPI call: retrieve a metric resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get :type project: string :param project: ID of the project containing the metric. :type metric_name: string :param metric_name: the name of the metric :rtype: dict :returns: The JSON metric object returned from the API. /projects/%s/metrics/%sr0r*r+rr,rHr9rrr metric_gets z_MetricsAPI.metric_getcCs.d||f}|||d}|jjd||ddS)aNAPI call: update a metric resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/update :type project: string :param project: ID of the project containing the metric. :type metric_name: string :param metric_name: the name of the metric :type filter_: string :param filter_: the advanced logs filter expression defining the entries exported by the metric. :type description: string :param description: description of the metric. rJrEr>rNr+rGrrr metric_updates  z_MetricsAPI.metric_updatecCs d||f}|jjd|ddS)aTAPI call: delete a metric resource. See: https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/delete :type project: string :param project: ID of the project containing the metric. :type metric_name: string :param metric_name: the name of the metric rJr)r*Nr+rKrrr metric_deletes z_MetricsAPI.metric_delete)NN)N) rrrrrrDrIrLrMrNrrrr rA3s % rAN) rZgcloudrZbase_connectionZJSONConnectionrobjectr r.rArrrr s  u