google-api-client 0.28.4 → 0.28.5

data/generated/google/apis/file_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/filestore/
     module FileV1
       VERSION = 'V1'
-      REVISION = '20190129'
+      REVISION = '20190312'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/file_v1/classes.rb

@@ -54,6 +54,149 @@ module Google
         end
       end
       
+      # File share configuration for the instance.
+      class FileShareConfig
+        include Google::Apis::Core::Hashable
+      
+        # File share capacity in gigabytes (GB).
+        # Cloud Filestore defines 1 GB as 1024^3 bytes.
+        # Corresponds to the JSON property `capacityGb`
+        # @return [Fixnum]
+        attr_accessor :capacity_gb
+      
+        # The name of the file share (must be 16 characters or less).
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @capacity_gb = args[:capacity_gb] if args.key?(:capacity_gb)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # A Cloud Filestore instance.
+      class Instance
+        include Google::Apis::Core::Hashable
+      
+        # Output only.
+        # The time when the instance was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Optional. A description of the instance (2048 characters or less).
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Server-specified ETag for the instance resource to prevent simultaneous
+        # updates from overwriting each other.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # File system shares on the instance.
+        # For this version, only a single file share is supported.
+        # Corresponds to the JSON property `fileShares`
+        # @return [Array<Google::Apis::FileV1::FileShareConfig>]
+        attr_accessor :file_shares
+      
+        # Resource labels to represent user provided metadata.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # Output only.
+        # The resource name of the instance, in the format
+        # projects/`project_id`/locations/`location_id`/instances/`instance_id`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # VPC networks to which the instance is connected.
+        # For this version, only a single network is supported.
+        # Corresponds to the JSON property `networks`
+        # @return [Array<Google::Apis::FileV1::NetworkConfig>]
+        attr_accessor :networks
+      
+        # Output only.
+        # The instance state.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only.
+        # Additional information about the instance state, if available.
+        # Corresponds to the JSON property `statusMessage`
+        # @return [String]
+        attr_accessor :status_message
+      
+        # The service tier of the instance.
+        # Corresponds to the JSON property `tier`
+        # @return [String]
+        attr_accessor :tier
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
+          @etag = args[:etag] if args.key?(:etag)
+          @file_shares = args[:file_shares] if args.key?(:file_shares)
+          @labels = args[:labels] if args.key?(:labels)
+          @name = args[:name] if args.key?(:name)
+          @networks = args[:networks] if args.key?(:networks)
+          @state = args[:state] if args.key?(:state)
+          @status_message = args[:status_message] if args.key?(:status_message)
+          @tier = args[:tier] if args.key?(:tier)
+        end
+      end
+      
+      # ListInstancesResponse is the result of ListInstancesRequest.
+      class ListInstancesResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of instances in the project for the specified location.
+        # If the `location` value in the request is "-", the response contains a list
+        # of instances from all locations. If any location is unreachable, the
+        # response will only return instances in reachable locations and the
+        # "unreachable" field will be populated with a list of unreachable locations.
+        # Corresponds to the JSON property `instances`
+        # @return [Array<Google::Apis::FileV1::Instance>]
+        attr_accessor :instances
+      
+        # The token you can use to retrieve the next page of results. Not returned
+        # if there are no more results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Locations that could not be reached.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @instances = args[:instances] if args.key?(:instances)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
+        end
+      end
+      
       # The response message for Locations.ListLocations.
       class ListLocationsResponse
         include Google::Apis::Core::Hashable
@@ -151,6 +294,56 @@ module Google
         end
       end
       
+      # Network configuration for the instance.
+      class NetworkConfig
+        include Google::Apis::Core::Hashable
+      
+        # Output only.
+        # IPv4 addresses in the format
+        # `octet 1`.`octet 2`.`octet 3`.`octet 4` or IPv6 addresses in the format
+        # `block 1`:`block 2`:`block 3`:`block 4`:`block 5`:`block 6`:`block 7`:`block 8`
+        # .
+        # Corresponds to the JSON property `ipAddresses`
+        # @return [Array<String>]
+        attr_accessor :ip_addresses
+      
+        # Internet protocol versions for which the instance has IP addresses
+        # assigned. For this version, only MODE_IPV4 is supported.
+        # Corresponds to the JSON property `modes`
+        # @return [Array<String>]
+        attr_accessor :modes
+      
+        # The name of the Google Compute Engine
+        # [VPC network](/compute/docs/networks-and-firewalls#networks) to which the
+        # instance is connected.
+        # Corresponds to the JSON property `network`
+        # @return [String]
+        attr_accessor :network
+      
+        # A /29 CIDR block in one of the
+        # [internal IP address ranges](https://www.arin.net/knowledge/address_filters.
+        # html)
+        # that identifies the range of IP addresses reserved for this
+        # instance. For example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify
+        # can't overlap with either existing subnets or assigned IP address ranges
+        # for other Cloud Filestore instances in the selected VPC network.
+        # Corresponds to the JSON property `reservedIpRange`
+        # @return [String]
+        attr_accessor :reserved_ip_range
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
+          @modes = args[:modes] if args.key?(:modes)
+          @network = args[:network] if args.key?(:network)
+          @reserved_ip_range = args[:reserved_ip_range] if args.key?(:reserved_ip_range)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -164,14 +357,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for different
-        # programming environments, including REST APIs and RPC APIs. It is used by
-        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # The `Status` type defines a logical error model that is suitable for
+        # different programming environments, including REST APIs and RPC APIs. It is
+        # used by [gRPC](https://github.com/grpc). The error model is designed to be:
         # - Simple to use and understand for most users
         # - Flexible enough to meet unexpected needs
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -307,14 +500,14 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for different
-      # programming environments, including REST APIs and RPC APIs. It is used by
-      # [gRPC](https://github.com/grpc). The error model is designed to be:
+      # The `Status` type defines a logical error model that is suitable for
+      # different programming environments, including REST APIs and RPC APIs. It is
+      # used by [gRPC](https://github.com/grpc). The error model is designed to be:
       # - Simple to use and understand for most users
       # - Flexible enough to meet unexpected needs
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing

data/generated/google/apis/file_v1/representations.rb

@@ -34,6 +34,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class FileShareConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Instance
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListInstancesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListLocationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -52,6 +70,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class NetworkConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -82,6 +106,42 @@ module Google
         end
       end
       
+      class FileShareConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :capacity_gb, :numeric_string => true, as: 'capacityGb'
+          property :name, as: 'name'
+        end
+      end
+      
+      class Instance
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :description, as: 'description'
+          property :etag, as: 'etag'
+          collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1::FileShareConfig, decorator: Google::Apis::FileV1::FileShareConfig::Representation
+      
+          hash :labels, as: 'labels'
+          property :name, as: 'name'
+          collection :networks, as: 'networks', class: Google::Apis::FileV1::NetworkConfig, decorator: Google::Apis::FileV1::NetworkConfig::Representation
+      
+          property :state, as: 'state'
+          property :status_message, as: 'statusMessage'
+          property :tier, as: 'tier'
+        end
+      end
+      
+      class ListInstancesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :instances, as: 'instances', class: Google::Apis::FileV1::Instance, decorator: Google::Apis::FileV1::Instance::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+          collection :unreachable, as: 'unreachable'
+        end
+      end
+      
       class ListLocationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -111,6 +171,16 @@ module Google
         end
       end
       
+      class NetworkConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :ip_addresses, as: 'ipAddresses'
+          collection :modes, as: 'modes'
+          property :network, as: 'network'
+          property :reserved_ip_range, as: 'reservedIpRange'
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/file_v1/service.rb

@@ -116,6 +116,196 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates an instance.
+        # @param [String] parent
+        #   The instance's project and location, in the format
+        #   projects/`project_id`/locations/`location`. In Cloud Filestore,
+        #   locations map to GCP zones, for example **us-west1-b**.
+        # @param [Google::Apis::FileV1::Instance] instance_object
+        # @param [String] instance_id
+        #   The name of the instance to create.
+        #   The name must be unique for the specified project and location.
+        # @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::FileV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Operation]
+        #
+        # @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 create_project_location_instance(parent, instance_object = nil, instance_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+parent}/instances', options)
+          command.request_representation = Google::Apis::FileV1::Instance::Representation
+          command.request_object = instance_object
+          command.response_representation = Google::Apis::FileV1::Operation::Representation
+          command.response_class = Google::Apis::FileV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['instanceId'] = instance_id unless instance_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes an instance.
+        # @param [String] name
+        #   The instance resource name, in the format
+        #   projects/`project_id`/locations/`location`/instances/`instance_id`
+        # @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::FileV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Operation]
+        #
+        # @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 delete_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FileV1::Operation::Representation
+          command.response_class = Google::Apis::FileV1::Operation
+          command.params['name'] = name unless 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
+        
+        # Gets the details of a specific instance.
+        # @param [String] name
+        #   The instance resource name, in the format
+        #   projects/`project_id`/locations/`location`/instances/`instance_id`.
+        # @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::FileV1::Instance] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Instance]
+        #
+        # @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_instance(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FileV1::Instance::Representation
+          command.response_class = Google::Apis::FileV1::Instance
+          command.params['name'] = name unless 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
+        
+        # Lists all instances in a project for either a specified location
+        # or for all locations.
+        # @param [String] parent
+        #   The project and location for which to retrieve instance information,
+        #   in the format projects/`project_id`/locations/`location`. In Cloud
+        #   Filestore, locations map to GCP zones, for example **us-west1-b**. To
+        #   retrieve instance information for all locations, use "-" for the `location`
+        #   value.
+        # @param [String] filter
+        #   List filter.
+        # @param [String] order_by
+        #   Sort results. Supported values are "name", "name desc" or "" (unsorted).
+        # @param [Fixnum] page_size
+        #   The maximum number of items to return.
+        # @param [String] page_token
+        #   The next_page_token value to use if there are additional
+        #   results to retrieve for this list request.
+        # @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::FileV1::ListInstancesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::ListInstancesResponse]
+        #
+        # @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 list_project_location_instances(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+parent}/instances', options)
+          command.response_representation = Google::Apis::FileV1::ListInstancesResponse::Representation
+          command.response_class = Google::Apis::FileV1::ListInstancesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the settings of a specific instance.
+        # @param [String] name
+        #   Output only.
+        #   The resource name of the instance, in the format
+        #   projects/`project_id`/locations/`location_id`/instances/`instance_id`.
+        # @param [Google::Apis::FileV1::Instance] instance_object
+        # @param [String] update_mask
+        #   Mask of fields to update.  At least one path must be supplied in this
+        #   field.  The elements of the repeated paths field may only include these
+        #   fields:
+        #   "description"
+        # @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::FileV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Operation]
+        #
+        # @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 patch_project_location_instance(name, instance_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::FileV1::Instance::Representation
+          command.request_object = instance_object
+          command.response_representation = Google::Apis::FileV1::Operation::Representation
+          command.response_class = Google::Apis::FileV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Starts asynchronous cancellation on a long-running operation.  The server
         # makes a best effort to cancel the operation, but success is not
         # guaranteed.  If the server doesn't support this method, it returns