Cloud Logging API . billingAccounts . locations . buckets . views

close()

Close httplib2 connections.

create(parent, body=None, viewId=None, x__xgafv=None)

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

Args:
  parent: string, Required. The bucket in which to create the view `"projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/locations/global/buckets/my-bucket" (required)
  body: object, The request body.
    The object takes the form of:

{ # Describes a view over log entries in a bucket.
  "createTime": "A String", # Output only. The creation timestamp of the view.
  "description": "A String", # Optional. Describes this view.
  "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
  "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
  "updateTime": "A String", # Output only. The last update timestamp of the view.
}

  viewId: string, Required. A client-assigned identifier such as "my-view". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Describes a view over log entries in a bucket.
  "createTime": "A String", # Output only. The creation timestamp of the view.
  "description": "A String", # Optional. Describes this view.
  "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
  "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
  "updateTime": "A String", # Output only. The last update timestamp of the view.
}

delete(name, x__xgafv=None)

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

Args:
  name: string, Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket/views/my-view" (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}

get(name, x__xgafv=None)

Gets a view on a log bucket.

Args:
  name: string, Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket/views/my-view" (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Describes a view over log entries in a bucket.
  "createTime": "A String", # Output only. The creation timestamp of the view.
  "description": "A String", # Optional. Describes this view.
  "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
  "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
  "updateTime": "A String", # Output only. The last update timestamp of the view.
}

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

Args:
  parent: string, Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"  (required)
  pageSize: integer, 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.
  pageToken: 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.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The response from ListViews.
  "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 the same method again using the value of nextPageToken as pageToken.
  "views": [ # A list of views.
    { # Describes a view over log entries in a bucket.
      "createTime": "A String", # Output only. The creation timestamp of the view.
      "description": "A String", # Optional. Describes this view.
      "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
      "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
      "updateTime": "A String", # Output only. The last update timestamp of the view.
    },
  ],
}

list_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        

patch(name, body=None, updateMask=None, x__xgafv=None)

Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

Args:
  name: string, Required. The full resource name of the view to update "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket/views/my-view" (required)
  body: object, The request body.
    The object takes the form of:

{ # Describes a view over log entries in a bucket.
  "createTime": "A String", # Output only. The creation timestamp of the view.
  "description": "A String", # Optional. Describes this view.
  "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
  "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
  "updateTime": "A String", # Output only. The last update timestamp of the view.
}

  updateMask: string, Optional. Field mask that specifies the fields in view that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=filter
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Describes a view over log entries in a bucket.
  "createTime": "A String", # Output only. The creation timestamp of the view.
  "description": "A String", # Optional. Describes this view.
  "filter": "A String", # Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
  "name": "A String", # Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
  "updateTime": "A String", # Output only. The last update timestamp of the view.
}