Refresh all docs (#298)
Change the discovery query to fetch all discovery docs, not just the
preferred ones.
diff --git a/docs/dyn/logging_v2.entries.html b/docs/dyn/logging_v2.entries.html
new file mode 100644
index 0000000..923dbaf
--- /dev/null
+++ b/docs/dyn/logging_v2.entries.html
@@ -0,0 +1,431 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+ margin: 0;
+ padding: 0;
+ border: 0;
+ font-weight: inherit;
+ font-style: inherit;
+ font-size: 100%;
+ font-family: inherit;
+ vertical-align: baseline;
+}
+
+body {
+ font-size: 13px;
+ padding: 1em;
+}
+
+h1 {
+ font-size: 26px;
+ margin-bottom: 1em;
+}
+
+h2 {
+ font-size: 24px;
+ margin-bottom: 1em;
+}
+
+h3 {
+ font-size: 20px;
+ margin-bottom: 1em;
+ margin-top: 1em;
+}
+
+pre, code {
+ line-height: 1.5;
+ font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+ margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+ font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+ border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+ margin-top: 0.5em;
+}
+
+.firstline {
+ margin-left: 2 em;
+}
+
+.method {
+ margin-top: 1em;
+ border: solid 1px #CCC;
+ padding: 1em;
+ background: #EEE;
+}
+
+.details {
+ font-weight: bold;
+ font-size: 14px;
+}
+
+</style>
+
+<h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.entries.html">entries</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+ <code><a href="#list">list(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists log entries. Use this method to retrieve log entries from Cloud</p>
+<p class="toc_element">
+ <code><a href="#write">write(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Writes log entries to Stackdriver Logging. All log entries are</p>
+<h3>Method Details</h3>
+<div class="method">
+ <code class="details" id="list">list(body, x__xgafv=None)</code>
+ <pre>Lists log entries. Use this method to retrieve log entries from Cloud
+Logging. For ways to export log entries, see
+[Exporting Logs](/logging/docs/export).
+
+Args:
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # The parameters to `ListLogEntries`.
+ "orderBy": "A String", # Optional. How the results should be sorted. Presently, the only permitted
+ # values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
+ # option returns entries in order of increasing values of
+ # `LogEntry.timestamp` (oldest first), and the second option returns entries
+ # in order of decreasing timestamps (newest first). Entries with equal
+ # timestamps are returned in order of `LogEntry.insertId`.
+ "resourceNames": [ # Required. One or more cloud resources from which to retrieve log entries.
+ # Example: `"projects/my-project-1A"`, `"projects/1234567890"`. Projects
+ # listed in `projectIds` are added to this list.
+ "A String",
+ ],
+ "pageSize": 42, # Optional. The maximum number of results to return from this request.
+ # Non-positive values are ignored. The presence of `nextPageToken` in the
+ # response indicates that more results might be available.
+ "filter": "A String", # Optional. A filter that chooses which log entries to return. See [Advanced
+ # Logs Filters](/logging/docs/view/advanced_filters). Only log entries that
+ # match the filter are returned. An empty filter matches all log entries.
+ "pageToken": "A String", # Optional. If present, then retrieve the next batch of results from the
+ # preceding call to this method. `pageToken` must be the value of
+ # `nextPageToken` from the previous response. The values of other method
+ # parameters should be identical to those in the previous call.
+ "projectIds": [ # Deprecated. One or more project identifiers or project numbers from which
+ # to retrieve log entries. Examples: `"my-project-1A"`, `"1234567890"`. If
+ # present, these project identifiers are converted to resource format and
+ # added to the list of resources in `resourceNames`. Callers should use
+ # `resourceNames` rather than this parameter.
+ "A String",
+ ],
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Result returned from `ListLogEntries`.
+ "nextPageToken": "A String", # If there might be more results than appear in this response, then
+ # `nextPageToken` is included. To get the next set of results, call this
+ # method again using the value of `nextPageToken` as `pageToken`.
+ "entries": [ # A list of log entries.
+ { # An individual entry in a log.
+ "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
+ # log entry, if applicable.
+ # defined by the HTTP specification. Product-specific logging
+ # information MUST be defined in a separate message.
+ "status": 42, # The response code indicating the status of response.
+ # Examples: 200, 404.
+ "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
+ # being served from cache. This field is only meaningful if `cache_hit` is
+ # True.
+ "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+ "latency": "A String", # The request processing latency on the server, from the time the request was
+ # received until the response was sent.
+ "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
+ # cache fill was attempted.
+ "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
+ # portion of the URL that was requested.
+ # Example: `"http://example.com/some/info?color=red"`.
+ "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
+ # sent to.
+ "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
+ "cacheHit": True or False, # Whether or not an entity was served from cache
+ # (with or without validation).
+ "referer": "A String", # The referer URL of the request, as defined in
+ # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+ "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
+ # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+ "userAgent": "A String", # The user agent sent by the client. Example:
+ # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+ "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
+ # headers and the request body.
+ "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
+ # including the response headers and the response body.
+ },
+ "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
+ # Example: a log entry that reports a database error would be
+ # associated with the monitored resource designating the particular
+ # database that reported the error.
+ # billing, or other purposes. Examples include virtual machine instances,
+ # databases, and storage devices such as disks. The `type` field identifies a
+ # MonitoredResourceDescriptor object that describes the resource's
+ # schema. Information in the `labels` field identifies the actual resource and
+ # its attributes according to the schema. For example, a particular Compute
+ # Engine VM instance could be represented by the following object, because the
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
+ # `"instance_id"` and `"zone"`:
+ #
+ # { "type": "gce_instance",
+ # "labels": { "instance_id": "12345678901234",
+ # "zone": "us-central1-a" }}
+ "labels": { # Required. Values for all of the labels listed in the associated monitored
+ # resource descriptor. For example, Cloud SQL databases use the labels
+ # `"database_id"` and `"zone"`.
+ "a_key": "A String",
+ },
+ "type": "A String", # Required. The monitored resource type. This field must match
+ # the `type` field of a MonitoredResourceDescriptor object. For
+ # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+ },
+ "severity": "A String", # Optional. The severity of the log entry. The default value is
+ # `LogSeverity.DEFAULT`.
+ "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
+ "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If
+ # omitted, Stackdriver Logging will use the time the log entry is received.
+ "labels": { # Optional. A set of user-defined (key, value) data that provides additional
+ # information about the log entry.
+ "a_key": "A String",
+ },
+ "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
+ # field, the logging service considers other log entries in the
+ # same project with the same ID as duplicates which can be removed. If
+ # omitted, Stackdriver Logging will generate a unique ID for this
+ # log entry.
+ "jsonPayload": { # The log entry payload, represented as a structure that
+ # is expressed as a JSON object.
+ "a_key": "", # Properties of the object.
+ },
+ "logName": "A String", # Required. The resource name of the log to which this log entry
+ # belongs. The format of the name is
+ # `"projects/<project-id>/logs/<log-id>"`. Examples:
+ # `"projects/my-projectid/logs/syslog"`,
+ # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
+ #
+ # The log ID part of resource name must be less than 512 characters
+ # long and can only include the following characters: upper and
+ # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
+ # characters: forward-slash, underscore, hyphen, and period.
+ # Forward-slash (`/`) characters in the log ID must be URL-encoded.
+ "protoPayload": { # The log entry payload, represented as a protocol buffer. Some
+ # Google Cloud Platform services use this field for their log
+ # entry payloads.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
+ # applicable.
+ # a log entry is associated.
+ "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
+ "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
+ # same identifier are assumed to be part of the same operation.
+ "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
+ # `id` and `producer` must be globally unique. Examples for `producer`:
+ # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+ "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
+ },
+ },
+ ],
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="write">write(body, x__xgafv=None)</code>
+ <pre>Writes log entries to Stackdriver Logging. All log entries are
+written by this method.
+
+Args:
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # The parameters to WriteLogEntries.
+ "resource": { # An object representing a resource that can be used for monitoring, logging, # Optional. A default monitored resource object that is assigned to all log
+ # entries in `entries` that do not specify a value for `resource`. Example:
+ #
+ # { "type": "gce_instance",
+ # "labels": {
+ # "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
+ #
+ # See LogEntry.
+ # billing, or other purposes. Examples include virtual machine instances,
+ # databases, and storage devices such as disks. The `type` field identifies a
+ # MonitoredResourceDescriptor object that describes the resource's
+ # schema. Information in the `labels` field identifies the actual resource and
+ # its attributes according to the schema. For example, a particular Compute
+ # Engine VM instance could be represented by the following object, because the
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
+ # `"instance_id"` and `"zone"`:
+ #
+ # { "type": "gce_instance",
+ # "labels": { "instance_id": "12345678901234",
+ # "zone": "us-central1-a" }}
+ "labels": { # Required. Values for all of the labels listed in the associated monitored
+ # resource descriptor. For example, Cloud SQL databases use the labels
+ # `"database_id"` and `"zone"`.
+ "a_key": "A String",
+ },
+ "type": "A String", # Required. The monitored resource type. This field must match
+ # the `type` field of a MonitoredResourceDescriptor object. For
+ # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+ },
+ "partialSuccess": True or False, # Optional. Whether valid entries should be written even if some other
+ # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
+ # entry is not written, the response status will be the error associated
+ # with one of the failed entries and include error details in the form of
+ # WriteLogEntriesPartialErrors.
+ "labels": { # Optional. Default labels that are added to the `labels` field of all log
+ # entries in `entries`. If a log entry already has a label with the same key
+ # as a label in this parameter, then the log entry's label is not changed.
+ # See LogEntry.
+ "a_key": "A String",
+ },
+ "logName": "A String", # Optional. A default log resource name that is assigned to all log entries
+ # in `entries` that do not specify a value for `log_name`. Example:
+ # `"projects/my-project/logs/syslog"`. See
+ # LogEntry.
+ "entries": [ # Required. The log entries to write. Values supplied for the fields
+ # `log_name`, `resource`, and `labels` in this `entries.write` request are
+ # added to those log entries that do not provide their own values for the
+ # fields.
+ #
+ # To improve throughput and to avoid exceeding the
+ # [quota limit](/logging/quota-policy) for calls to `entries.write`,
+ # you should write multiple log entries at once rather than
+ # calling this method for each individual log entry.
+ { # An individual entry in a log.
+ "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
+ # log entry, if applicable.
+ # defined by the HTTP specification. Product-specific logging
+ # information MUST be defined in a separate message.
+ "status": 42, # The response code indicating the status of response.
+ # Examples: 200, 404.
+ "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
+ # being served from cache. This field is only meaningful if `cache_hit` is
+ # True.
+ "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+ "latency": "A String", # The request processing latency on the server, from the time the request was
+ # received until the response was sent.
+ "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
+ # cache fill was attempted.
+ "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
+ # portion of the URL that was requested.
+ # Example: `"http://example.com/some/info?color=red"`.
+ "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
+ # sent to.
+ "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
+ "cacheHit": True or False, # Whether or not an entity was served from cache
+ # (with or without validation).
+ "referer": "A String", # The referer URL of the request, as defined in
+ # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+ "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
+ # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+ "userAgent": "A String", # The user agent sent by the client. Example:
+ # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+ "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
+ # headers and the request body.
+ "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
+ # including the response headers and the response body.
+ },
+ "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
+ # Example: a log entry that reports a database error would be
+ # associated with the monitored resource designating the particular
+ # database that reported the error.
+ # billing, or other purposes. Examples include virtual machine instances,
+ # databases, and storage devices such as disks. The `type` field identifies a
+ # MonitoredResourceDescriptor object that describes the resource's
+ # schema. Information in the `labels` field identifies the actual resource and
+ # its attributes according to the schema. For example, a particular Compute
+ # Engine VM instance could be represented by the following object, because the
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
+ # `"instance_id"` and `"zone"`:
+ #
+ # { "type": "gce_instance",
+ # "labels": { "instance_id": "12345678901234",
+ # "zone": "us-central1-a" }}
+ "labels": { # Required. Values for all of the labels listed in the associated monitored
+ # resource descriptor. For example, Cloud SQL databases use the labels
+ # `"database_id"` and `"zone"`.
+ "a_key": "A String",
+ },
+ "type": "A String", # Required. The monitored resource type. This field must match
+ # the `type` field of a MonitoredResourceDescriptor object. For
+ # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+ },
+ "severity": "A String", # Optional. The severity of the log entry. The default value is
+ # `LogSeverity.DEFAULT`.
+ "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
+ "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If
+ # omitted, Stackdriver Logging will use the time the log entry is received.
+ "labels": { # Optional. A set of user-defined (key, value) data that provides additional
+ # information about the log entry.
+ "a_key": "A String",
+ },
+ "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
+ # field, the logging service considers other log entries in the
+ # same project with the same ID as duplicates which can be removed. If
+ # omitted, Stackdriver Logging will generate a unique ID for this
+ # log entry.
+ "jsonPayload": { # The log entry payload, represented as a structure that
+ # is expressed as a JSON object.
+ "a_key": "", # Properties of the object.
+ },
+ "logName": "A String", # Required. The resource name of the log to which this log entry
+ # belongs. The format of the name is
+ # `"projects/<project-id>/logs/<log-id>"`. Examples:
+ # `"projects/my-projectid/logs/syslog"`,
+ # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
+ #
+ # The log ID part of resource name must be less than 512 characters
+ # long and can only include the following characters: upper and
+ # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
+ # characters: forward-slash, underscore, hyphen, and period.
+ # Forward-slash (`/`) characters in the log ID must be URL-encoded.
+ "protoPayload": { # The log entry payload, represented as a protocol buffer. Some
+ # Google Cloud Platform services use this field for their log
+ # entry payloads.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
+ # applicable.
+ # a log entry is associated.
+ "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
+ "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
+ # same identifier are assumed to be part of the same operation.
+ "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
+ # `id` and `producer` must be globally unique. Examples for `producer`:
+ # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+ "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
+ },
+ },
+ ],
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Result returned from WriteLogEntries.
+ # empty
+ }</pre>
+</div>
+
+</body></html>
\ No newline at end of file