chiu/google-api-ruby-client
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Bump version, regen APIs

Browse Source
This commit is contained in:
Steve Bazyl committed 2017-05-26 10:44:32 -06:00
1 parent b8f6f7c2fe
commit 9237ba59cb
241 files changed
+53894 -50212
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

generated/google/apis/servicecontrol_v1/classes.rb
+776 -775
View File
File diff suppressed because it is too large. Load diff
generated/google/apis/servicecontrol_v1/representations.rb
+208 -208
View File
@@ -22,6 +22,78 @@ module Google
module Apis
module ServicecontrolV1
class AllocateQuotaResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class ReleaseQuotaRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class QuotaError
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class RequestMetadata
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class CheckInfo
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class ReleaseQuotaResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class AllocateQuotaRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class MetricValueSet
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class ReportError
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class StartReconciliationRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class CheckError
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class QuotaInfo
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class CheckRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
@@ -46,13 +118,13 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class ReportResponse
class Operation
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class Operation
class ReportResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
@@ -76,13 +148,13 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class LogEntry
class AuditLog
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class AuditLog
class LogEntry
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
@@ -94,13 +166,13 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class EndReconciliationResponse
class Money
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class Money
class EndReconciliationResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
@@ -155,98 +227,138 @@ module Google
end
class AllocateQuotaResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :operation_id, as: 'operationId'
property :service_config_id, as: 'serviceConfigId'
collection :allocate_errors, as: 'allocateErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
include Google::Apis::Core::JsonObjectSupport
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
end
end
class ReleaseQuotaRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :service_config_id, as: 'serviceConfigId'
property :release_operation, as: 'releaseOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
include Google::Apis::Core::JsonObjectSupport
end
class RequestMetadata
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
end
class QuotaError
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :subject, as: 'subject'
property :description, as: 'description'
property :code, as: 'code'
end
end
include Google::Apis::Core::JsonObjectSupport
class RequestMetadata
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :caller_supplied_user_agent, as: 'callerSuppliedUserAgent'
property :caller_ip, as: 'callerIp'
end
end
class CheckInfo
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :unused_arguments, as: 'unusedArguments'
end
end
class ReleaseQuotaResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :service_config_id, as: 'serviceConfigId'
collection :release_errors, as: 'releaseErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
include Google::Apis::Core::JsonObjectSupport
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
property :operation_id, as: 'operationId'
end
end
class AllocateQuotaRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :service_config_id, as: 'serviceConfigId'
property :allocate_operation, as: 'allocateOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
include Google::Apis::Core::JsonObjectSupport
property :allocation_mode, as: 'allocationMode'
end
end
class MetricValueSet
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :metric_name, as: 'metricName'
collection :metric_values, as: 'metricValues', class: Google::Apis::ServicecontrolV1::MetricValue, decorator: Google::Apis::ServicecontrolV1::MetricValue::Representation
include Google::Apis::Core::JsonObjectSupport
end
end
class ReportError
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :operation_id, as: 'operationId'
property :status, as: 'status', class: Google::Apis::ServicecontrolV1::Status, decorator: Google::Apis::ServicecontrolV1::Status::Representation
include Google::Apis::Core::JsonObjectSupport
end
class CheckError
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
end
class StartReconciliationRequest
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :reconciliation_operation, as: 'reconciliationOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
include Google::Apis::Core::JsonObjectSupport
property :service_config_id, as: 'serviceConfigId'
end
end
class CheckError
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :detail, as: 'detail'
property :code, as: 'code'
end
end
class QuotaInfo
class Representation < Google::Apis::Core::JsonRepresentation; end
# @private
class Representation < Google::Apis::Core::JsonRepresentation
hash :quota_consumed, as: 'quotaConsumed'
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
include Google::Apis::Core::JsonObjectSupport
collection :limit_exceeded, as: 'limitExceeded'
end
end
class CheckRequest
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :skip_activation_check, as: 'skipActivationCheck'
property :operation, as: 'operation', class: Google::Apis::ServicecontrolV1::Operation, decorator: Google::Apis::ServicecontrolV1::Operation::Representation
property :request_project_settings, as: 'requestProjectSettings'
property :service_config_id, as: 'serviceConfigId'
property :skip_activation_check, as: 'skipActivationCheck'
end
end
class QuotaOperation
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :quota_mode, as: 'quotaMode'
property :method_name, as: 'methodName'
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
hash :labels, as: 'labels'
property :consumer_id, as: 'consumerId'
property :operation_id, as: 'operationId'
property :method_name, as: 'methodName'
property :quota_mode, as: 'quotaMode'
end
end
@@ -268,20 +380,11 @@ module Google
end
end
class ReportResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :report_infos, as: 'reportInfos', class: Google::Apis::ServicecontrolV1::ReportInfo, decorator: Google::Apis::ServicecontrolV1::ReportInfo::Representation
property :service_config_id, as: 'serviceConfigId'
collection :report_errors, as: 'reportErrors', class: Google::Apis::ServicecontrolV1::ReportError, decorator: Google::Apis::ServicecontrolV1::ReportError::Representation
end
end
class Operation
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :quota_properties, as: 'quotaProperties', class: Google::Apis::ServicecontrolV1::QuotaProperties, decorator: Google::Apis::ServicecontrolV1::QuotaProperties::Representation
property :consumer_id, as: 'consumerId'
property :operation_id, as: 'operationId'
property :operation_name, as: 'operationName'
@@ -295,8 +398,17 @@ module Google
hash :user_labels, as: 'userLabels'
collection :metric_value_sets, as: 'metricValueSets', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
property :quota_properties, as: 'quotaProperties', class: Google::Apis::ServicecontrolV1::QuotaProperties, decorator: Google::Apis::ServicecontrolV1::QuotaProperties::Representation
end
end
class ReportResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :report_errors, as: 'reportErrors', class: Google::Apis::ServicecontrolV1::ReportError, decorator: Google::Apis::ServicecontrolV1::ReportError::Representation
collection :report_infos, as: 'reportInfos', class: Google::Apis::ServicecontrolV1::ReportInfo, decorator: Google::Apis::ServicecontrolV1::ReportInfo::Representation
property :service_config_id, as: 'serviceConfigId'
end
end
@@ -332,25 +444,16 @@ module Google
end
end
class LogEntry
# @private
class Representation < Google::Apis::Core::JsonRepresentation
hash :labels, as: 'labels'
property :severity, as: 'severity'
property :insert_id, as: 'insertId'
property :name, as: 'name'
hash :struct_payload, as: 'structPayload'
property :text_payload, as: 'textPayload'
hash :proto_payload, as: 'protoPayload'
property :timestamp, as: 'timestamp'
end
end
class AuditLog
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :service_name, as: 'serviceName'
property :num_response_items, :numeric_string => true, as: 'numResponseItems'
property :status, as: 'status', class: Google::Apis::ServicecontrolV1::Status, decorator: Google::Apis::ServicecontrolV1::Status::Representation
property :authentication_info, as: 'authenticationInfo', class: Google::Apis::ServicecontrolV1::AuthenticationInfo, decorator: Google::Apis::ServicecontrolV1::AuthenticationInfo::Representation
hash :response, as: 'response'
property :service_name, as: 'serviceName'
property :method_name, as: 'methodName'
collection :authorization_info, as: 'authorizationInfo', class: Google::Apis::ServicecontrolV1::AuthorizationInfo, decorator: Google::Apis::ServicecontrolV1::AuthorizationInfo::Representation
@@ -359,28 +462,46 @@ module Google
property :request_metadata, as: 'requestMetadata', class: Google::Apis::ServicecontrolV1::RequestMetadata, decorator: Google::Apis::ServicecontrolV1::RequestMetadata::Representation
hash :service_data, as: 'serviceData'
property :num_response_items, :numeric_string => true, as: 'numResponseItems'
property :status, as: 'status', class: Google::Apis::ServicecontrolV1::Status, decorator: Google::Apis::ServicecontrolV1::Status::Representation
property :authentication_info, as: 'authenticationInfo', class: Google::Apis::ServicecontrolV1::AuthenticationInfo, decorator: Google::Apis::ServicecontrolV1::AuthenticationInfo::Representation
end
end
class LogEntry
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :timestamp, as: 'timestamp'
hash :labels, as: 'labels'
property :severity, as: 'severity'
property :insert_id, as: 'insertId'
property :name, as: 'name'
hash :struct_payload, as: 'structPayload'
property :text_payload, as: 'textPayload'
hash :proto_payload, as: 'protoPayload'
end
end
class MetricValue
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :bool_value, as: 'boolValue'
property :end_time, as: 'endTime'
property :start_time, as: 'startTime'
property :money_value, as: 'moneyValue', class: Google::Apis::ServicecontrolV1::Money, decorator: Google::Apis::ServicecontrolV1::Money::Representation
hash :labels, as: 'labels'
property :string_value, as: 'stringValue'
hash :labels, as: 'labels'
property :double_value, as: 'doubleValue'
property :int64_value, :numeric_string => true, as: 'int64Value'
property :distribution_value, as: 'distributionValue', class: Google::Apis::ServicecontrolV1::Distribution, decorator: Google::Apis::ServicecontrolV1::Distribution::Representation
property :bool_value, as: 'boolValue'
property :end_time, as: 'endTime'
end
end
class Money
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :currency_code, as: 'currencyCode'
property :nanos, as: 'nanos'
property :units, :numeric_string => true, as: 'units'
end
end
@@ -396,15 +517,6 @@ module Google
end
end
class Money
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :currency_code, as: 'currencyCode'
property :nanos, as: 'nanos'
property :units, :numeric_string => true, as: 'units'
end
end
class ExplicitBuckets
# @private
class Representation < Google::Apis::Core::JsonRepresentation
@@ -415,8 +527,11 @@ module Google
class Distribution
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :count, :numeric_string => true, as: 'count'
property :linear_buckets, as: 'linearBuckets', class: Google::Apis::ServicecontrolV1::LinearBuckets, decorator: Google::Apis::ServicecontrolV1::LinearBuckets::Representation
property :minimum, as: 'minimum'
property :mean, as: 'mean'
property :count, :numeric_string => true, as: 'count'
collection :bucket_counts, as: 'bucketCounts'
property :explicit_buckets, as: 'explicitBuckets', class: Google::Apis::ServicecontrolV1::ExplicitBuckets, decorator: Google::Apis::ServicecontrolV1::ExplicitBuckets::Representation
@@ -424,18 +539,15 @@ module Google
property :sum_of_squared_deviation, as: 'sumOfSquaredDeviation'
property :exponential_buckets, as: 'exponentialBuckets', class: Google::Apis::ServicecontrolV1::ExponentialBuckets, decorator: Google::Apis::ServicecontrolV1::ExponentialBuckets::Representation
property :linear_buckets, as: 'linearBuckets', class: Google::Apis::ServicecontrolV1::LinearBuckets, decorator: Google::Apis::ServicecontrolV1::LinearBuckets::Representation
property :minimum, as: 'minimum'
end
end
class ExponentialBuckets
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :growth_factor, as: 'growthFactor'
property :scale, as: 'scale'
property :num_finite_buckets, as: 'numFiniteBuckets'
property :growth_factor, as: 'growthFactor'
end
end
@@ -451,149 +563,37 @@ module Google
class StartReconciliationResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :operation_id, as: 'operationId'
collection :reconciliation_errors, as: 'reconciliationErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
property :service_config_id, as: 'serviceConfigId'
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
property :operation_id, as: 'operationId'
collection :reconciliation_errors, as: 'reconciliationErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
end
end
class QuotaProperties
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :quota_mode, as: 'quotaMode'
hash :limit_by_ids, as: 'limitByIds'
property :quota_mode, as: 'quotaMode'
end
end
class LinearBuckets
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :num_finite_buckets, as: 'numFiniteBuckets'
property :width, as: 'width'
property :offset, as: 'offset'
property :num_finite_buckets, as: 'numFiniteBuckets'
end
end
class AuthenticationInfo
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :authority_selector, as: 'authoritySelector'
property :principal_email, as: 'principalEmail'
end
end
class AllocateQuotaResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :operation_id, as: 'operationId'
property :service_config_id, as: 'serviceConfigId'
collection :allocate_errors, as: 'allocateErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
end
end
class ReleaseQuotaRequest
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :service_config_id, as: 'serviceConfigId'
property :release_operation, as: 'releaseOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
end
end
class RequestMetadata
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :caller_supplied_user_agent, as: 'callerSuppliedUserAgent'
property :caller_ip, as: 'callerIp'
end
end
class QuotaError
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :subject, as: 'subject'
property :description, as: 'description'
property :code, as: 'code'
end
end
class CheckInfo
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :unused_arguments, as: 'unusedArguments'
end
end
class ReleaseQuotaResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :release_errors, as: 'releaseErrors', class: Google::Apis::ServicecontrolV1::QuotaError, decorator: Google::Apis::ServicecontrolV1::QuotaError::Representation
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
property :operation_id, as: 'operationId'
property :service_config_id, as: 'serviceConfigId'
end
end
class AllocateQuotaRequest
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :allocate_operation, as: 'allocateOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
property :allocation_mode, as: 'allocationMode'
property :service_config_id, as: 'serviceConfigId'
end
end
class MetricValueSet
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :metric_name, as: 'metricName'
collection :metric_values, as: 'metricValues', class: Google::Apis::ServicecontrolV1::MetricValue, decorator: Google::Apis::ServicecontrolV1::MetricValue::Representation
end
end
class ReportError
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :operation_id, as: 'operationId'
property :status, as: 'status', class: Google::Apis::ServicecontrolV1::Status, decorator: Google::Apis::ServicecontrolV1::Status::Representation
end
end
class CheckError
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :code, as: 'code'
property :detail, as: 'detail'
end
end
class StartReconciliationRequest
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :reconciliation_operation, as: 'reconciliationOperation', class: Google::Apis::ServicecontrolV1::QuotaOperation, decorator: Google::Apis::ServicecontrolV1::QuotaOperation::Representation
property :service_config_id, as: 'serviceConfigId'
end
end
class QuotaInfo
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :limit_exceeded, as: 'limitExceeded'
hash :quota_consumed, as: 'quotaConsumed'
collection :quota_metrics, as: 'quotaMetrics', class: Google::Apis::ServicecontrolV1::MetricValueSet, decorator: Google::Apis::ServicecontrolV1::MetricValueSet::Representation
property :authority_selector, as: 'authoritySelector'
end
end
end
generated/google/apis/servicecontrol_v1/service.rb
+57 -57
View File
@@ -48,63 +48,6 @@ module Google
@batch_path = 'batch'
end
# Unlike rate quota, allocation quota does not get refilled periodically.
# So, it is possible that the quota usage as seen by the service differs from
# what the One Platform considers the usage is. This is expected to happen
# only rarely, but over time this can accumulate. Services can invoke
# StartReconciliation and EndReconciliation to correct this usage drift, as
# described below:
# 1. Service sends StartReconciliation with a timestamp in future for each
# metric that needs to be reconciled. The timestamp being in future allows
# to account for in-flight AllocateQuota and ReleaseQuota requests for the
# same metric.
# 2. One Platform records this timestamp and starts tracking subsequent
# AllocateQuota and ReleaseQuota requests until EndReconciliation is
# called.
# 3. At or after the time specified in the StartReconciliation, service
# sends EndReconciliation with the usage that needs to be reconciled to.
# 4. One Platform adjusts its own record of usage for that metric to the
# value specified in EndReconciliation by taking in to account any
# allocation or release between StartReconciliation and EndReconciliation.
# Signals the quota controller that the service wants to perform a usage
# reconciliation as specified in the request.
# This method requires the `servicemanagement.services.quota`
# permission on the specified service. For more information, see
# [Google Cloud IAM](https://cloud.google.com/iam).
# @param [String] service_name
# Name of the service as specified in the service configuration. For example,
# `"pubsub.googleapis.com"`.
# See google.api.Service for the definition of a service name.
# @param [Google::Apis::ServicecontrolV1::StartReconciliationRequest] start_reconciliation_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# 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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ServicecontrolV1::StartReconciliationResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ServicecontrolV1::StartReconciliationResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
# @raise [Google::Apis::AuthorizationError] Authorization is required
def start_service_reconciliation(service_name, start_reconciliation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:post, 'v1/services/{serviceName}:startReconciliation', options)
command.request_representation = Google::Apis::ServicecontrolV1::StartReconciliationRequest::Representation
command.request_object = start_reconciliation_request_object
command.response_representation = Google::Apis::ServicecontrolV1::StartReconciliationResponse::Representation
command.response_class = Google::Apis::ServicecontrolV1::StartReconciliationResponse
command.params['serviceName'] = service_name unless service_name.nil?
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
# Checks an operation with Google Service Control to decide whether
# the given operation should proceed. It should be called before the
# operation is executed.
@@ -325,6 +268,63 @@ module Google
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
# Unlike rate quota, allocation quota does not get refilled periodically.
# So, it is possible that the quota usage as seen by the service differs from
# what the One Platform considers the usage is. This is expected to happen
# only rarely, but over time this can accumulate. Services can invoke
# StartReconciliation and EndReconciliation to correct this usage drift, as
# described below:
# 1. Service sends StartReconciliation with a timestamp in future for each
# metric that needs to be reconciled. The timestamp being in future allows
# to account for in-flight AllocateQuota and ReleaseQuota requests for the
# same metric.
# 2. One Platform records this timestamp and starts tracking subsequent
# AllocateQuota and ReleaseQuota requests until EndReconciliation is
# called.
# 3. At or after the time specified in the StartReconciliation, service
# sends EndReconciliation with the usage that needs to be reconciled to.
# 4. One Platform adjusts its own record of usage for that metric to the
# value specified in EndReconciliation by taking in to account any
# allocation or release between StartReconciliation and EndReconciliation.
# Signals the quota controller that the service wants to perform a usage
# reconciliation as specified in the request.
# This method requires the `servicemanagement.services.quota`
# permission on the specified service. For more information, see
# [Google Cloud IAM](https://cloud.google.com/iam).
# @param [String] service_name
# Name of the service as specified in the service configuration. For example,
# `"pubsub.googleapis.com"`.
# See google.api.Service for the definition of a service name.
# @param [Google::Apis::ServicecontrolV1::StartReconciliationRequest] start_reconciliation_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# 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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ServicecontrolV1::StartReconciliationResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ServicecontrolV1::StartReconciliationResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
# @raise [Google::Apis::AuthorizationError] Authorization is required
def start_service_reconciliation(service_name, start_reconciliation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:post, 'v1/services/{serviceName}:startReconciliation', options)
command.request_representation = Google::Apis::ServicecontrolV1::StartReconciliationRequest::Representation
command.request_object = start_reconciliation_request_object
command.response_representation = Google::Apis::ServicecontrolV1::StartReconciliationResponse::Representation
command.response_class = Google::Apis::ServicecontrolV1::StartReconciliationResponse
command.params['serviceName'] = service_name unless service_name.nil?
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
protected