Class: Google::Apis::ClouderrorreportingV1beta1::ClouderrorreportingService

Inherits:
Google::Apis::Core::BaseService show all
Defined in:
generated/google/apis/clouderrorreporting_v1beta1/service.rb

Overview

Stackdriver Error Reporting API

Groups and counts similar errors from cloud services and applications, reports new errors, and provides access to error groups and their associated errors.

Examples:

require 'google/apis/clouderrorreporting_v1beta1'

Clouderrorreporting = Google::Apis::ClouderrorreportingV1beta1 # Alias the module
service = Clouderrorreporting::ClouderrorreportingService.new

See Also:

Instance Attribute Summary collapse

Attributes inherited from Google::Apis::Core::BaseService

#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path

Instance Method Summary collapse

Methods inherited from Google::Apis::Core::BaseService

#batch, #batch_upload, #fetch_all, #http

Methods included from Google::Apis::Core::Logging

#logger

Constructor Details

#initialize ⇒ ClouderrorreportingService

Returns a new instance of ClouderrorreportingService



46
47
48
49
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 46

def initialize
  super('https://clouderrorreporting.googleapis.com/', '')
  @batch_path = 'batch'
end

Instance Attribute Details

#key ⇒ String

Returns API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

Returns:

  • (String) —

    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.



39
40
41
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 39

def key
  @key
end

#quota_user ⇒ String

Returns Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

Returns:

  • (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.



44
45
46
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 44

def quota_user
  @quota_user
end

Instance Method Details

#delete_project_events(project_name, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::DeleteEventsResponse

Deletes all error events of a given project.

Parameters:

  • project_name (String) —

    [Required] The resource name of the Google Cloud Platform project. Written as projects/ plus the Google Cloud Platform project ID. Example: projects/my-project-123.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



75
76
77
78
79
80
81
82
83
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 75

def delete_project_events(project_name, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:delete, 'v1beta1/{+projectName}/events', options)
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::DeleteEventsResponse::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::DeleteEventsResponse
  command.params['projectName'] = project_name unless project_name.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end

#get_project_group(group_name, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::ErrorGroup

Get the specified group.

Parameters:

  • group_name (String) —

    [Required] The group resource name. Written as projects/projectID/groups/group_name. Call groupStats.list to return a list of groups belonging to this project. Example: projects/my-project-123/groups/my-group

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



191
192
193
194
195
196
197
198
199
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 191

def get_project_group(group_name, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1beta1/{+groupName}', options)
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::ErrorGroup::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::ErrorGroup
  command.params['groupName'] = group_name unless group_name.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end

#list_project_events(project_name, service_filter_service: nil, page_token: nil, page_size: nil, service_filter_version: nil, service_filter_resource_type: nil, time_range_period: nil, group_id: nil, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::ListEventsResponse

Lists the specified events.

Parameters:

  • project_name (String) —

    [Required] The resource name of the Google Cloud Platform project. Written as projects/ plus the Google Cloud Platform project ID. Example: projects/my-project-123.

  • service_filter_service (String) —

    [Optional] The exact value to match against ServiceContext.service.

  • page_token (String) —

    [Optional] A next_page_token provided by a previous response.

  • page_size (Fixnum) —

    [Optional] The maximum number of results to return per response.

  • service_filter_version (String) —

    [Optional] The exact value to match against ServiceContext.version.

  • service_filter_resource_type (String) —

    [Optional] The exact value to match against ServiceContext.resource_type.

  • time_range_period (String) —

    Restricts the query to the specified time range.

  • group_id (String) —

    [Required] The group for which events shall be returned.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 280

def list_project_events(project_name, service_filter_service: nil, page_token: nil, page_size: nil, service_filter_version: nil, service_filter_resource_type: nil, time_range_period: nil, group_id: nil, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1beta1/{+projectName}/events', options)
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::ListEventsResponse::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::ListEventsResponse
  command.params['projectName'] = project_name unless project_name.nil?
  command.query['serviceFilter.service'] = service_filter_service unless service_filter_service.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['serviceFilter.version'] = service_filter_version unless service_filter_version.nil?
  command.query['serviceFilter.resourceType'] = service_filter_resource_type unless service_filter_resource_type.nil?
  command.query['timeRange.period'] = time_range_period unless time_range_period.nil?
  command.query['groupId'] = group_id unless group_id.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end

#list_project_group_stats(project_name, alignment: nil, group_id: nil, service_filter_service: nil, page_size: nil, order: nil, service_filter_version: nil, alignment_time: nil, service_filter_resource_type: nil, timed_count_duration: nil, page_token: nil, time_range_period: nil, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::ListGroupStatsResponse

Lists the specified groups.

Parameters:

  • project_name (String) —

    [Required] The resource name of the Google Cloud Platform project. Written as projects/ plus the Google Cloud Platform project ID. Example: projects/my-project-123.

  • alignment (String) —

    [Optional] The alignment of the timed counts to be returned. Default is ALIGNMENT_EQUAL_AT_END.

  • group_id (Array<String>, String) —

    [Optional] List all ErrorGroupStats with these IDs.

  • service_filter_service (String) —

    [Optional] The exact value to match against ServiceContext.service.

  • page_size (Fixnum) —

    [Optional] The maximum number of results to return per response. Default is 20.

  • order (String) —

    [Optional] The sort order in which the results are returned. Default is COUNT_DESC.

  • service_filter_version (String) —

    [Optional] The exact value to match against ServiceContext.version.

  • alignment_time (String) —

    [Optional] Time where the timed counts shall be aligned if rounded alignment is chosen. Default is 00:00 UTC.

  • service_filter_resource_type (String) —

    [Optional] The exact value to match against ServiceContext.resource_type.

  • timed_count_duration (String) —

    [Optional] The preferred duration for a single returned TimedCount. If not set, no timed counts are returned.

  • page_token (String) —

    [Optional] A next_page_token provided by a previous response. To view additional results, pass this token along with the identical query parameters as the first request.

  • time_range_period (String) —

    Restricts the query to the specified time range.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 144

def list_project_group_stats(project_name, alignment: nil, group_id: nil, service_filter_service: nil, page_size: nil, order: nil, service_filter_version: nil, alignment_time: nil, service_filter_resource_type: nil, timed_count_duration: nil, page_token: nil, time_range_period: nil, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1beta1/{+projectName}/groupStats', options)
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::ListGroupStatsResponse::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::ListGroupStatsResponse
  command.params['projectName'] = project_name unless project_name.nil?
  command.query['alignment'] = alignment unless alignment.nil?
  command.query['groupId'] = group_id unless group_id.nil?
  command.query['serviceFilter.service'] = service_filter_service unless service_filter_service.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['order'] = order unless order.nil?
  command.query['serviceFilter.version'] = service_filter_version unless service_filter_version.nil?
  command.query['alignmentTime'] = alignment_time unless alignment_time.nil?
  command.query['serviceFilter.resourceType'] = service_filter_resource_type unless service_filter_resource_type.nil?
  command.query['timedCountDuration'] = timed_count_duration unless timed_count_duration.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['timeRange.period'] = time_range_period unless time_range_period.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end

#report_project_event(project_name, reported_error_event_object = nil, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::ReportErrorEventResponse

Report an individual error event. This endpoint accepts either an OAuth token, or an API key for authentication. To use an API key, append it to the URL as the value of a key parameter. For example:

POST https://clouderrorreporting.googleapis.com/v1beta1/projects/example-
project/events:report?key=123ABC456

Parameters:

  • project_name (String) —

    [Required] The resource name of the Google Cloud Platform project. Written as projects/ plus the Google Cloud Platform project ID. Example: projects/my-project-123.

  • reported_error_event_object (Google::Apis::ClouderrorreportingV1beta1::ReportedErrorEvent) (defaults to: nil)
  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



329
330
331
332
333
334
335
336
337
338
339
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 329

def report_project_event(project_name, reported_error_event_object = nil, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1beta1/{+projectName}/events:report', options)
  command.request_representation = Google::Apis::ClouderrorreportingV1beta1::ReportedErrorEvent::Representation
  command.request_object = reported_error_event_object
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::ReportErrorEventResponse::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::ReportErrorEventResponse
  command.params['projectName'] = project_name unless project_name.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end

#update_project_group(name, error_group_object = nil, quota_user: nil, fields: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ClouderrorreportingV1beta1::ErrorGroup

Replace the data for the specified group. Fails if the group does not exist.

Parameters:

  • name (String) —

    The group resource name. Example: projects/my-project-123/groups/my-groupid

  • error_group_object (Google::Apis::ClouderrorreportingV1beta1::ErrorGroup) (defaults to: nil)
  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



224
225
226
227
228
229
230
231
232
233
234
 
# File 'generated/google/apis/clouderrorreporting_v1beta1/service.rb', line 224

def update_project_group(name, error_group_object = nil, quota_user: nil, fields: nil, options: nil, &block)
  command =  make_simple_command(:put, 'v1beta1/{+name}', options)
  command.request_representation = Google::Apis::ClouderrorreportingV1beta1::ErrorGroup::Representation
  command.request_object = error_group_object
  command.response_representation = Google::Apis::ClouderrorreportingV1beta1::ErrorGroup::Representation
  command.response_class = Google::Apis::ClouderrorreportingV1beta1::ErrorGroup
  command.params['name'] = name unless name.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  command.query['fields'] = fields unless fields.nil?
  execute_or_queue_command(command, &block)
end