From f6e204d1ac96a76a0a7b28af222238bd81512699 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Wed, 5 Dec 2018 00:36:30 +0000 Subject: [PATCH] Autogenerated update (2018-12-05) Update: - cloudkms_v1 - cloudsearch_v1 - iap_v1beta1 - servicenetworking_v1beta --- api_names_out.yaml | 6 + generated/google/apis/cloudkms_v1.rb | 2 +- generated/google/apis/cloudkms_v1/service.rb | 107 ++++++++++++++ generated/google/apis/cloudsearch_v1.rb | 2 +- .../google/apis/cloudsearch_v1/classes.rb | 2 +- generated/google/apis/iap_v1beta1.rb | 2 +- generated/google/apis/iap_v1beta1/classes.rb | 132 ------------------ .../apis/iap_v1beta1/representations.rb | 32 ----- .../google/apis/servicenetworking_v1beta.rb | 2 +- .../apis/servicenetworking_v1beta/classes.rb | 81 ++++++----- .../apis/servicenetworking_v1beta/service.rb | 103 +++++++------- 11 files changed, 212 insertions(+), 259 deletions(-) diff --git a/api_names_out.yaml b/api_names_out.yaml index ae61f87bf..b63da2287 100644 --- a/api_names_out.yaml +++ b/api_names_out.yaml @@ -15987,6 +15987,12 @@ "/cloudkms:v1/cloudkms.projects.locations.keyRings.get/name": name "/cloudkms:v1/cloudkms.projects.locations.keyRings.getIamPolicy": get_project_location_key_ring_iam_policy "/cloudkms:v1/cloudkms.projects.locations.keyRings.getIamPolicy/resource": resource +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.getIamPolicy": get_project_location_key_ring_import_job_iam_policy +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.getIamPolicy/resource": resource +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.setIamPolicy": set_import_job_iam_policy +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.setIamPolicy/resource": resource +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.testIamPermissions": test_import_job_iam_permissions +"/cloudkms:v1/cloudkms.projects.locations.keyRings.importJobs.testIamPermissions/resource": resource "/cloudkms:v1/cloudkms.projects.locations.keyRings.list": list_project_location_key_rings "/cloudkms:v1/cloudkms.projects.locations.keyRings.list/pageSize": page_size "/cloudkms:v1/cloudkms.projects.locations.keyRings.list/pageToken": page_token diff --git a/generated/google/apis/cloudkms_v1.rb b/generated/google/apis/cloudkms_v1.rb index 57c47ab99..e8392780e 100644 --- a/generated/google/apis/cloudkms_v1.rb +++ b/generated/google/apis/cloudkms_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/kms/ module CloudkmsV1 VERSION = 'V1' - REVISION = '20181107' + REVISION = '20181130' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudkms_v1/service.rb b/generated/google/apis/cloudkms_v1/service.rb index b07db6ff0..2a9fdf81a 100644 --- a/generated/google/apis/cloudkms_v1/service.rb +++ b/generated/google/apis/cloudkms_v1/service.rb @@ -1038,6 +1038,113 @@ module Google command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end + + # Gets the access control policy for a resource. + # Returns an empty policy if the resource exists and does not have a policy + # set. + # @param [String] resource + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. + # @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::CloudkmsV1::Policy] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::CloudkmsV1::Policy] + # + # @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 get_project_location_key_ring_import_job_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options) + command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation + command.response_class = Google::Apis::CloudkmsV1::Policy + command.params['resource'] = resource unless resource.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Sets the access control policy on the specified resource. Replaces any + # existing policy. + # @param [String] resource + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. + # @param [Google::Apis::CloudkmsV1::SetIamPolicyRequest] set_iam_policy_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::CloudkmsV1::Policy] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::CloudkmsV1::Policy] + # + # @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 set_import_job_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options) + command.request_representation = Google::Apis::CloudkmsV1::SetIamPolicyRequest::Representation + command.request_object = set_iam_policy_request_object + command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation + command.response_class = Google::Apis::CloudkmsV1::Policy + command.params['resource'] = resource unless resource.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Returns permissions that a caller has on the specified resource. + # If the resource does not exist, this will return an empty set of + # permissions, not a NOT_FOUND error. + # Note: This operation is designed to be used for building permission-aware + # UIs and command-line tools, not for authorization checking. This operation + # may "fail open" without warning. + # @param [String] resource + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. + # @param [Google::Apis::CloudkmsV1::TestIamPermissionsRequest] test_iam_permissions_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::CloudkmsV1::TestIamPermissionsResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::CloudkmsV1::TestIamPermissionsResponse] + # + # @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 test_import_job_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options) + command.request_representation = Google::Apis::CloudkmsV1::TestIamPermissionsRequest::Representation + command.request_object = test_iam_permissions_request_object + command.response_representation = Google::Apis::CloudkmsV1::TestIamPermissionsResponse::Representation + command.response_class = Google::Apis::CloudkmsV1::TestIamPermissionsResponse + command.params['resource'] = resource unless resource.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 diff --git a/generated/google/apis/cloudsearch_v1.rb b/generated/google/apis/cloudsearch_v1.rb index e7104eb74..0809e7b53 100644 --- a/generated/google/apis/cloudsearch_v1.rb +++ b/generated/google/apis/cloudsearch_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://gsuite.google.com/products/cloud-search/ module CloudsearchV1 VERSION = 'V1' - REVISION = '20181120' + REVISION = '20181203' # Index and serve your organization's data with Cloud Search AUTH_CLOUD_SEARCH = 'https://www.googleapis.com/auth/cloud_search' diff --git a/generated/google/apis/cloudsearch_v1/classes.rb b/generated/google/apis/cloudsearch_v1/classes.rb index a1b429800..b7691d6d9 100644 --- a/generated/google/apis/cloudsearch_v1/classes.rb +++ b/generated/google/apis/cloudsearch_v1/classes.rb @@ -1079,7 +1079,7 @@ module Google # This property indicates the freshness level of the object in the index. # If set, this property must be a top-level property within the - # PropertyDefinitions + # property definitions # and it must be a # timestamp type # or diff --git a/generated/google/apis/iap_v1beta1.rb b/generated/google/apis/iap_v1beta1.rb index e1c9caa3a..227648dd2 100644 --- a/generated/google/apis/iap_v1beta1.rb +++ b/generated/google/apis/iap_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/iap module IapV1beta1 VERSION = 'V1beta1' - REVISION = '20180919' + REVISION = '20181128' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/iap_v1beta1/classes.rb b/generated/google/apis/iap_v1beta1/classes.rb index defec6684..0c098f9de 100644 --- a/generated/google/apis/iap_v1beta1/classes.rb +++ b/generated/google/apis/iap_v1beta1/classes.rb @@ -22,122 +22,6 @@ module Google module Apis module IapV1beta1 - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices" - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:foo@gmail.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE", - # `, - # ` - # "log_type": "ADMIN_READ", - # ` - # ] - # `, - # ` - # "service": "fooservice.googleapis.com" - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:bar@gmail.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts foo@gmail.com from DATA_READ logging, and - # bar@gmail.com from DATA_WRITE logging. - class AuditConfig - include Google::Apis::Core::Hashable - - # The configuration for logging of each type of permission. - # Corresponds to the JSON property `auditLogConfigs` - # @return [Array] - attr_accessor :audit_log_configs - - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. - # Corresponds to the JSON property `service` - # @return [String] - attr_accessor :service - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @audit_log_configs = args[:audit_log_configs] if args.key?(:audit_log_configs) - @service = args[:service] if args.key?(:service) - end - end - - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:foo@gmail.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE", - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # foo@gmail.com from DATA_READ logging. - class AuditLogConfig - include Google::Apis::Core::Hashable - - # Specifies the identities that do not cause logging for this type of - # permission. - # Follows the same format of Binding.members. - # Corresponds to the JSON property `exemptedMembers` - # @return [Array] - attr_accessor :exempted_members - - # The log type that this config enables. - # Corresponds to the JSON property `logType` - # @return [String] - attr_accessor :log_type - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @exempted_members = args[:exempted_members] if args.key?(:exempted_members) - @log_type = args[:log_type] if args.key?(:log_type) - end - end - # Associates `members` with a `role`. class Binding include Google::Apis::Core::Hashable @@ -286,11 +170,6 @@ module Google class Policy include Google::Apis::Core::Hashable - # Specifies cloud audit logging configuration for this policy. - # Corresponds to the JSON property `auditConfigs` - # @return [Array] - attr_accessor :audit_configs - # Associates a list of `members` to a `role`. # `bindings` with no members will result in an error. # Corresponds to the JSON property `bindings` @@ -322,7 +201,6 @@ module Google # Update properties of this object def update!(**args) - @audit_configs = args[:audit_configs] if args.key?(:audit_configs) @bindings = args[:bindings] if args.key?(:bindings) @etag = args[:etag] if args.key?(:etag) @version = args[:version] if args.key?(:version) @@ -374,15 +252,6 @@ module Google # @return [Google::Apis::IapV1beta1::Policy] attr_accessor :policy - # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # paths: "bindings, etag" - # This field is only used by Cloud IAM. - # Corresponds to the JSON property `updateMask` - # @return [String] - attr_accessor :update_mask - def initialize(**args) update!(**args) end @@ -390,7 +259,6 @@ module Google # Update properties of this object def update!(**args) @policy = args[:policy] if args.key?(:policy) - @update_mask = args[:update_mask] if args.key?(:update_mask) end end diff --git a/generated/google/apis/iap_v1beta1/representations.rb b/generated/google/apis/iap_v1beta1/representations.rb index 92c6fcc6a..c84edfce1 100644 --- a/generated/google/apis/iap_v1beta1/representations.rb +++ b/generated/google/apis/iap_v1beta1/representations.rb @@ -22,18 +22,6 @@ module Google module Apis module IapV1beta1 - class AuditConfig - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class AuditLogConfig - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class Binding class Representation < Google::Apis::Core::JsonRepresentation; end @@ -76,23 +64,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class AuditConfig - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :audit_log_configs, as: 'auditLogConfigs', class: Google::Apis::IapV1beta1::AuditLogConfig, decorator: Google::Apis::IapV1beta1::AuditLogConfig::Representation - - property :service, as: 'service' - end - end - - class AuditLogConfig - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :exempted_members, as: 'exemptedMembers' - property :log_type, as: 'logType' - end - end - class Binding # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -122,8 +93,6 @@ module Google class Policy # @private class Representation < Google::Apis::Core::JsonRepresentation - collection :audit_configs, as: 'auditConfigs', class: Google::Apis::IapV1beta1::AuditConfig, decorator: Google::Apis::IapV1beta1::AuditConfig::Representation - collection :bindings, as: 'bindings', class: Google::Apis::IapV1beta1::Binding, decorator: Google::Apis::IapV1beta1::Binding::Representation property :etag, :base64 => true, as: 'etag' @@ -136,7 +105,6 @@ module Google class Representation < Google::Apis::Core::JsonRepresentation property :policy, as: 'policy', class: Google::Apis::IapV1beta1::Policy, decorator: Google::Apis::IapV1beta1::Policy::Representation - property :update_mask, as: 'updateMask' end end diff --git a/generated/google/apis/servicenetworking_v1beta.rb b/generated/google/apis/servicenetworking_v1beta.rb index 43d606d2d..97486f7df 100644 --- a/generated/google/apis/servicenetworking_v1beta.rb +++ b/generated/google/apis/servicenetworking_v1beta.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started module ServicenetworkingV1beta VERSION = 'V1beta' - REVISION = '20181115' + REVISION = '20181204' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/servicenetworking_v1beta/classes.rb b/generated/google/apis/servicenetworking_v1beta/classes.rb index 66308d4b5..c29232366 100644 --- a/generated/google/apis/servicenetworking_v1beta/classes.rb +++ b/generated/google/apis/servicenetworking_v1beta/classes.rb @@ -26,41 +26,40 @@ module Google class AddSubnetworkRequest include Google::Apis::Core::Hashable - # Required. Resource representing service consumer. It may be different from - # the project number in consumer network parameter in case of that network - # being a shared VPC network. In that case, Service Networking will validate - # that this resource belongs to that shared VPC. - # For example 'projects/123456'. + # Required. A resource that represents the service consumer, such as + # `projects/123456`. The project number can be different from the + # value in the consumer network parameter. For example, the network might be + # part of a Shared VPC network. In those cases, Service Networking validates + # that this resource belongs to that Shared VPC. # Corresponds to the JSON property `consumer` # @return [String] attr_accessor :consumer - # Required. Network name in the consumer project. This network must have been - # already peered with a shared VPC network using CreateConnection - # method. - # Must be in a form 'projects/`project`/global/networks/`network`'. - # `project` is a project number, as in '12345' - # `network` is network name. + # Required. The name of the service consumer's VPC network. The network + # must have an existing private connection that was provisioned through the + # connections.create method. The name must be in the following format: + # `projects/`project`/global/networks/`network``, where `project` + # is a project number, such as `12345`. `network` is the name of a + # VPC network in the project. # Corresponds to the JSON property `consumerNetwork` # @return [String] attr_accessor :consumer_network - # Optional. Description of the subnetwork. + # An optional description of the subnet. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Required. The prefix length of the IP range. - # Use usual CIDR range notation. - # For example, '30' to provision subnet with x.x.x.x/30 CIDR range. - # Actual range will be determined using allocated range for the consumer - # peered network and returned in the result. + # Required. The prefix length of the subnet's IP address range. Use CIDR + # range notation, such as `30` to provision a subnet with an + # `x.x.x.x/30` CIDR range. The IP address range is drawn from a + # pool of available ranges in the service consumer's allocated range. # Corresponds to the JSON property `ipPrefixLength` # @return [Fixnum] attr_accessor :ip_prefix_length - # Required. Cloud [region](/compute/docs/reference/rest/v1/regions) for the new - # subnetwork. + # Required. The name of a [region](/compute/docs/regions-zones) + # for the subnet, such `europe-west1`. # Corresponds to the JSON property `region` # @return [String] attr_accessor :region @@ -74,15 +73,15 @@ module Google # @return [String] attr_accessor :requested_address - # Required. Name for the new subnetwork. - # Must be a legal [subnetwork](compute/docs/reference/rest/v1/subnetworks) - # name. + # Required. A name for the new subnet. For information about the naming + # requirements, see [subnetwork](/compute/docs/reference/rest/v1/subnetworks) + # in the Compute API documentation. # Corresponds to the JSON property `subnetwork` # @return [String] attr_accessor :subnetwork - # Optional. List of members that will be granted 'compute.networkUser' role - # on the newly added subnetwork. + # A list of members that are granted the `compute.networkUser` + # role on the subnet. # Corresponds to the JSON property `subnetworkUsers` # @return [Array] attr_accessor :subnetwork_users @@ -557,26 +556,31 @@ module Google end end - # Message returning the created service connection. + # Represents a private connection resource. A private connection is implemented + # as a VPC Network Peering connection between a service producer's VPC network + # and a service consumer's VPC network. class Connection include Google::Apis::Core::Hashable - # Name of VPC network connected with service producer network. - # Must be in a form 'projects/`project`/global/networks/`network`'. - # `project` is a project number, as in '12345' - # `network` is a network name. + # The name of service consumer's VPC network that's connected with service + # producer network, in the following format: + # `projects/`project`/global/networks/`network``. + # ``project`` is a project number, such as in `12345` that includes + # the VPC service consumer's VPC network. ``network`` is the name of the + # service consumer's VPC network. # Corresponds to the JSON property `network` # @return [String] attr_accessor :network # Output only. - # Name of the peering connection that is created by the peering service. + # The name of the VPC Network Peering connection that was created by the + # service producer. # Corresponds to the JSON property `peering` # @return [String] attr_accessor :peering - # Named IP address range(s) of PEERING type allocated for this service - # provider. + # The name of one or more allocated IP address ranges for this service + # producer of type `PEERING`. # Note that invoking this method with a different range when connection is # already established will not modify already provisioned service # producer subnetworks. @@ -585,8 +589,8 @@ module Google attr_accessor :reserved_peering_ranges # Output only. - # Name of the peering service associated with this connection. - # "services/`service name` + # The name of the peering service that's associated with this connection, in + # the following format: `services/`service name``. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service @@ -3178,11 +3182,11 @@ module Google end end - # Message returning the created service subnetwork. + # Represents a subnet that was created by a peered service. class Subnetwork include Google::Apis::Core::Hashable - # Subnetwork CIDR range in "10.x.x.x/y" format. + # Subnetwork CIDR range in `10.x.x.x/y` format. # Corresponds to the JSON property `ipCidrRange` # @return [String] attr_accessor :ip_cidr_range @@ -3193,8 +3197,9 @@ module Google # @return [String] attr_accessor :name - # Shared VPC host project network peered with consumer network. - # For example: projects/1234321/global/networks/host-network + # In the Shared VPC host project, the VPC network that's peered with the + # consumer network. For example: + # `projects/1234321/global/networks/host-network` # Corresponds to the JSON property `network` # @return [String] attr_accessor :network diff --git a/generated/google/apis/servicenetworking_v1beta/service.rb b/generated/google/apis/servicenetworking_v1beta/service.rb index ac4cd3988..d9357ebf9 100644 --- a/generated/google/apis/servicenetworking_v1beta/service.rb +++ b/generated/google/apis/servicenetworking_v1beta/service.rb @@ -80,25 +80,23 @@ module Google execute_or_queue_command(command, &block) end - # Service producers use this method to provision a new subnet in - # peered service shared VPC network. - # It will validate previously provided allocated ranges, find - # non-conflicting sub-range of requested size (expressed in - # number of leading bits of ipv4 network mask, as in CIDR range - # notation). It will then create a subnetwork in the request - # region. The subsequent call will try to reuse the - # subnetwork previously created if subnetwork name, region and - # prefix length of the IP range match. - # Operation + # For service producers, provisions a new subnet in a + # peered service's shared VPC network in the requested region and with the + # requested size that's expressed as a CIDR range (number of leading bits of + # ipV4 network mask). The method checks against the assigned allocated ranges + # to find a non-conflicting IP address range. The method will reuse a subnet + # if subsequent calls contain the same subnet name, region, prefix length. + # The response from the `get` operation will be of type `Subnetwork` if the + # operation successfully completes. # @param [String] parent - # Required. This is a 'tenant' project in the service producer organization. - # services/`service`/`collection-id`/`resource-id` - # `collection id` is the cloud resource collection type representing the - # tenant project. Only 'projects' are currently supported. - # `resource id` is the tenant project numeric id: '123456'. - # `service` the name of the peering service, for example - # 'service-peering.example.com'. This service must be activated. - # in the consumer project. + # Required. A tenant project in the service producer organization, in the + # following format: services/`service`/`collection-id`/`resource-id`. + # `collection-id` is the cloud resource collection type that represents the + # tenant project. Only `projects` are supported. + # `resource-id` is the tenant project numeric id, such as + # `123456`. `service` the name of the peering service, such as + # `service-peering.example.com`. This service must already be + # enabled in the service consumer's project. # @param [Google::Apis::ServicenetworkingV1beta::AddSubnetworkRequest] add_subnetwork_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -129,20 +127,21 @@ module Google execute_or_queue_command(command, &block) end - # Allocated ranges specified for the connection may be updated. - # Operation. + # Updates the allocated ranges that are assigned to a connection. + # The response from the `get` operation will be of type `Connection` if the + # operation successfully completes. # @param [String] name - # Provider peering service that is managing peering connectivity for a - # service provider organization. - # For Google services that support this functionality it is - # 'services/servicenetworking.googleapis.com'. + # The service producer peering service that is managing peering connectivity + # for a service producer organization. + # For Google services that support this functionality, this is + # `services/servicenetworking.googleapis.com`. # @param [Google::Apis::ServicenetworkingV1beta::Connection] connection_object # @param [Boolean] force # If a previously defined allocated range is removed, force flag must be # set to true. # @param [String] update_mask - # The update mask. If this is omitted, it defaults to "*". Only reserved - # peering ranges list may be updated. + # The update mask. If this is omitted, it defaults to "*". You can only + # update the listed peering ranges. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -174,20 +173,19 @@ module Google execute_or_queue_command(command, &block) end - # To connect service to a VPC network peering connection - # must be established prior to service provisioning. - # This method must be invoked by the consumer VPC network administrator - # It will establish a permanent peering connection with a shared - # network created in the service producer organization and register a - # allocated IP range(s) to be used for service subnetwork provisioning. - # This connection will be used for all supported services in the service - # producer organization, so it only needs to be invoked once. - # Operation. + # Creates a private connection that establishes a VPC Network Peering + # connection to a VPC network in the service producer's organization. + # The administrator of the service consumer's VPC network invokes this + # method. The administrator must assign one or more allocated IP ranges for + # provisioning subnetworks in the service producer's VPC network. This + # connection is used for all supported services in the service producer's + # organization, so it only needs to be invoked once. The response from the + # `get` operation will be of type `Connection` if the operation successfully + # completes. # @param [String] parent - # Provider peering service that is managing peering connectivity for a - # service provider organization. - # For Google services that support this functionality it is - # 'services/servicenetworking.googleapis.com'. + # The service that is managing peering connectivity for a service producer's + # organization. For Google services that support this functionality, this + # value is `services/servicenetworking.googleapis.com`. # @param [Google::Apis::ServicenetworkingV1beta::Connection] connection_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -218,21 +216,22 @@ module Google execute_or_queue_command(command, &block) end - # Service consumers use this method to list configured peering connection for - # the given service and consumer network. + # List the private connections that are configured in a service consumer's + # VPC network. # @param [String] parent - # Provider peering service that is managing peering connectivity for a - # service provider organization. - # For Google services that support this functionality it is - # 'services/servicenetworking.googleapis.com'. - # For "-" all configured public peering services will be queried. + # The service that is managing peering connectivity for a service producer's + # organization. For Google services that support this functionality, this + # value is `services/servicenetworking.googleapis.com`. + # If you specify `-` as the parameter value, all configured public peering + # services are listed. # @param [String] network - # Network name in the consumer project. This network must have been - # already peered with a shared VPC network using CreateConnection - # method. - # Must be in a form 'projects/`project`/global/networks/`network`'. - # `project` is a project number, as in '12345' - # `network` is network name. + # The name of service consumer's VPC network that's connected with service + # producer network through a private connection. The network name must be in + # the following format: + # `projects/`project`/global/networks/`network``. `project` is a + # project number, such as in `12345` that includes the VPC service + # consumer's VPC network. `network` is the name of the service consumer's VPC + # network. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user