google-apis-tpu_v2 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce2c355c739486f3012db5b12639367bb2a0ce2c61acbdc61b65db17587ca756
-  data.tar.gz: a7ae6c0777d274918ee798085c595b7a2fd975a556ab421e43dca596fbe6087c
+  metadata.gz: 4840e7135ff68e140c1bebaad8b13516bfa48db456044307536874fca2237431
+  data.tar.gz: ff31c324bf4b54ac06ccfa522625ca3662dbabcdfb363aeb7928aa98975e2fd8
 SHA512:
-  metadata.gz: 957a9f1c1cbf1023d7a2bbe7746829c7aa14e7230c95e94cc5629cacd254ceaa2045780bd31e470a534590d5bf67324c8379bfc4c7f828fedb6c25da0061e3d2
-  data.tar.gz: 4cab452a78f739bef4aa281466117acdb52a5f4ac2deaa074e0fa76aeabe4f5105694b4fa0db026197a1c6b6999fad215bf38c7f98b9f924e4419070fb98e4a4
+  metadata.gz: 69f4ae23f5ab4e80e0cbe1b25cb3287a628eb109eee0fd7eecc65458febaa7483b8ca38b563d469c9a2578d16de2ac1bb3c7632b300882b4a889403f143d7254
+  data.tar.gz: 76d19b42a52835ddc4d3dc8cd657678afe3bc005808796544e3d7094b11eeda9e0c2f06a7a3936b7cad0b76232703b20f981a5c78da18b8ec3a68fe06a55206d

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Release history for google-apis-tpu_v2
 
+### v0.10.0 (2024-02-23)
+
+* Regenerated from discovery document revision 20240205
+* Regenerated using generator version 0.14.0
+
+### v0.9.0 (2024-01-23)
+
+* Regenerated from discovery document revision 20240111
+* Regenerated using generator version 0.13.0
+
 ### v0.8.0 (2023-08-13)
 
 * Regenerated from discovery document revision 20230803

data/OVERVIEW.md

@@ -83,9 +83,9 @@ The [product documentation](https://cloud.google.com/tpu/) may provide guidance
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.7+.
 
-Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
+Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 
 ## License
 

data/lib/google/apis/tpu_v2/classes.rb

@@ -78,6 +78,19 @@ module Google
         end
       end
       
+      # Further data for the accepted state.
+      class AcceptedData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # An access config attached to the TPU worker.
       class AccessConfig
         include Google::Apis::Core::Hashable
@@ -97,6 +110,19 @@ module Google
         end
       end
       
+      # Further data for the active state.
+      class ActiveData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A node-attached disk resource. Next ID: 8;
       class AttachedDisk
         include Google::Apis::Core::Hashable
@@ -124,6 +150,32 @@ module Google
         end
       end
       
+      # Further data for the creating state.
+      class CreatingData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Further data for the deleting state.
+      class DeletingData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -140,6 +192,30 @@ module Google
         end
       end
       
+      # Further data for the failed state.
+      class FailedData
+        include Google::Apis::Core::Hashable
+      
+        # 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). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::TpuV2::Status]
+        attr_accessor :error
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @error = args[:error] if args.key?(:error)
+        end
+      end
+      
       # Request for GenerateServiceIdentity.
       class GenerateServiceIdentityRequest
         include Google::Apis::Core::Hashable
@@ -217,6 +293,27 @@ module Google
         end
       end
       
+      # Guaranteed tier definition.
+      class Guaranteed
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Defines the minimum duration of the guarantee. If specified, the
+        # requested resources will only be provisioned if they can be allocated for at
+        # least the given duration.
+        # Corresponds to the JSON property `minDuration`
+        # @return [String]
+        attr_accessor :min_duration
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @min_duration = args[:min_duration] if args.key?(:min_duration)
+        end
+      end
+      
       # A guest attributes.
       class GuestAttributes
         include Google::Apis::Core::Hashable
@@ -293,6 +390,36 @@ module Google
         end
       end
       
+      # Represents a time interval, encoded as a Timestamp start (inclusive) and a
+      # Timestamp end (exclusive). The start must be less than or equal to the end.
+      # When the start equals the end, the interval is empty (matches no time). When
+      # both start and end are unspecified, the interval matches any time.
+      class Interval
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Exclusive end of the interval. If specified, a Timestamp matching
+        # this interval will have to be before the end.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Optional. Inclusive start of the interval. If specified, a Timestamp matching
+        # this interval will have to be the same or after the start.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
       # Response for ListAcceleratorTypes.
       class ListAcceleratorTypesResponse
         include Google::Apis::Core::Hashable
@@ -405,6 +532,37 @@ module Google
         end
       end
       
+      # Response for ListQueuedResources.
+      class ListQueuedResourcesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The next page token or empty if none.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The listed queued resources.
+        # Corresponds to the JSON property `queuedResources`
+        # @return [Array<Google::Apis::TpuV2::QueuedResource>]
+        attr_accessor :queued_resources
+      
+        # 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)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @queued_resources = args[:queued_resources] if args.key?(:queued_resources)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
+        end
+      end
+      
       # Response for ListRuntimeVersions.
       class ListRuntimeVersionsResponse
         include Google::Apis::Core::Hashable
@@ -483,6 +641,36 @@ module Google
         end
       end
       
+      # Parameters to specify for multislice QueuedResource requests. This message
+      # must be populated in case of multislice requests instead of node_id.
+      class MultisliceParams
+        include Google::Apis::Core::Hashable
+      
+        # Required. Number of nodes with this spec. The system will attempt to provison "
+        # node_count" nodes as part of the request. This needs to be > 1.
+        # Corresponds to the JSON property `nodeCount`
+        # @return [Fixnum]
+        attr_accessor :node_count
+      
+        # Optional. Prefix of node_ids in case of multislice request. Should follow the `
+        # ^[A-Za-z0-9_.~+%-]+$` regex format. If node_count = 3 and node_id_prefix = "np"
+        # , node ids of nodes created will be "np-0", "np-1", "np-2". If this field is
+        # not provided we use queued_resource_id as the node_id_prefix.
+        # Corresponds to the JSON property `nodeIdPrefix`
+        # @return [String]
+        attr_accessor :node_id_prefix
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @node_count = args[:node_count] if args.key?(:node_count)
+          @node_id_prefix = args[:node_id_prefix] if args.key?(:node_id_prefix)
+        end
+      end
+      
       # Network related configurations.
       class NetworkConfig
         include Google::Apis::Core::Hashable
@@ -509,6 +697,12 @@ module Google
         # @return [String]
         attr_accessor :network
       
+        # Optional. Specifies networking queue count for TPU VM instance's network
+        # interface.
+        # Corresponds to the JSON property `queueCount`
+        # @return [Fixnum]
+        attr_accessor :queue_count
+      
         # The name of the subnetwork for the TPU node. It must be a preexisting Google
         # Compute Engine subnetwork. If none is provided, "default" will be used.
         # Corresponds to the JSON property `subnetwork`
@@ -524,6 +718,7 @@ module Google
           @can_ip_forward = args[:can_ip_forward] if args.key?(:can_ip_forward)
           @enable_external_ips = args[:enable_external_ips] if args.key?(:enable_external_ips)
           @network = args[:network] if args.key?(:network)
+          @queue_count = args[:queue_count] if args.key?(:queue_count)
           @subnetwork = args[:subnetwork] if args.key?(:subnetwork)
         end
       end
@@ -728,6 +923,48 @@ module Google
         end
       end
       
+      # Details of the TPU node(s) being requested. Users can request either a single
+      # node or multiple nodes. NodeSpec provides the specification for node(s) to be
+      # created.
+      class NodeSpec
+        include Google::Apis::Core::Hashable
+      
+        # Parameters to specify for multislice QueuedResource requests. This message
+        # must be populated in case of multislice requests instead of node_id.
+        # Corresponds to the JSON property `multisliceParams`
+        # @return [Google::Apis::TpuV2::MultisliceParams]
+        attr_accessor :multislice_params
+      
+        # A TPU instance.
+        # Corresponds to the JSON property `node`
+        # @return [Google::Apis::TpuV2::Node]
+        attr_accessor :node
+      
+        # Optional. The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+
+        # $` regex format. This is only specified when requesting a single node. In case
+        # of multislice requests, multislice_params must be populated instead.
+        # Corresponds to the JSON property `nodeId`
+        # @return [String]
+        attr_accessor :node_id
+      
+        # Required. The parent resource name.
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @multislice_params = args[:multislice_params] if args.key?(:multislice_params)
+          @node = args[:node] if args.key?(:node)
+          @node_id = args[:node_id] if args.key?(:node_id)
+          @parent = args[:parent] if args.key?(:parent)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -847,6 +1084,218 @@ module Google
         end
       end
       
+      # Further data for the provisioning state.
+      class ProvisioningData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A QueuedResource represents a request for resources that will be placed in a
+      # queue and fulfilled when the necessary resources are available.
+      class QueuedResource
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The time when the QueuedResource was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Guaranteed tier definition.
+        # Corresponds to the JSON property `guaranteed`
+        # @return [Google::Apis::TpuV2::Guaranteed]
+        attr_accessor :guaranteed
+      
+        # Output only. Immutable. The name of the QueuedResource.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Defines the policy of the QueuedRequest.
+        # Corresponds to the JSON property `queueingPolicy`
+        # @return [Google::Apis::TpuV2::QueueingPolicy]
+        attr_accessor :queueing_policy
+      
+        # Optional. Name of the reservation in which the resource should be provisioned.
+        # Format: projects/`project`/locations/`zone`/reservations/`reservation`
+        # Corresponds to the JSON property `reservationName`
+        # @return [String]
+        attr_accessor :reservation_name
+      
+        # Spot tier definition.
+        # Corresponds to the JSON property `spot`
+        # @return [Google::Apis::TpuV2::Spot]
+        attr_accessor :spot
+      
+        # QueuedResourceState defines the details of the QueuedResource request.
+        # Corresponds to the JSON property `state`
+        # @return [Google::Apis::TpuV2::QueuedResourceState]
+        attr_accessor :state
+      
+        # Details of the TPU resource(s) being requested.
+        # Corresponds to the JSON property `tpu`
+        # @return [Google::Apis::TpuV2::Tpu]
+        attr_accessor :tpu
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @guaranteed = args[:guaranteed] if args.key?(:guaranteed)
+          @name = args[:name] if args.key?(:name)
+          @queueing_policy = args[:queueing_policy] if args.key?(:queueing_policy)
+          @reservation_name = args[:reservation_name] if args.key?(:reservation_name)
+          @spot = args[:spot] if args.key?(:spot)
+          @state = args[:state] if args.key?(:state)
+          @tpu = args[:tpu] if args.key?(:tpu)
+        end
+      end
+      
+      # QueuedResourceState defines the details of the QueuedResource request.
+      class QueuedResourceState
+        include Google::Apis::Core::Hashable
+      
+        # Further data for the accepted state.
+        # Corresponds to the JSON property `acceptedData`
+        # @return [Google::Apis::TpuV2::AcceptedData]
+        attr_accessor :accepted_data
+      
+        # Further data for the active state.
+        # Corresponds to the JSON property `activeData`
+        # @return [Google::Apis::TpuV2::ActiveData]
+        attr_accessor :active_data
+      
+        # Further data for the creating state.
+        # Corresponds to the JSON property `creatingData`
+        # @return [Google::Apis::TpuV2::CreatingData]
+        attr_accessor :creating_data
+      
+        # Further data for the deleting state.
+        # Corresponds to the JSON property `deletingData`
+        # @return [Google::Apis::TpuV2::DeletingData]
+        attr_accessor :deleting_data
+      
+        # Further data for the failed state.
+        # Corresponds to the JSON property `failedData`
+        # @return [Google::Apis::TpuV2::FailedData]
+        attr_accessor :failed_data
+      
+        # Further data for the provisioning state.
+        # Corresponds to the JSON property `provisioningData`
+        # @return [Google::Apis::TpuV2::ProvisioningData]
+        attr_accessor :provisioning_data
+      
+        # Output only. State of the QueuedResource request.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only. The initiator of the QueuedResources's current state. Used to
+        # indicate whether the SUSPENDING/SUSPENDED state was initiated by the user or
+        # the service.
+        # Corresponds to the JSON property `stateInitiator`
+        # @return [String]
+        attr_accessor :state_initiator
+      
+        # Further data for the suspended state.
+        # Corresponds to the JSON property `suspendedData`
+        # @return [Google::Apis::TpuV2::SuspendedData]
+        attr_accessor :suspended_data
+      
+        # Further data for the suspending state.
+        # Corresponds to the JSON property `suspendingData`
+        # @return [Google::Apis::TpuV2::SuspendingData]
+        attr_accessor :suspending_data
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accepted_data = args[:accepted_data] if args.key?(:accepted_data)
+          @active_data = args[:active_data] if args.key?(:active_data)
+          @creating_data = args[:creating_data] if args.key?(:creating_data)
+          @deleting_data = args[:deleting_data] if args.key?(:deleting_data)
+          @failed_data = args[:failed_data] if args.key?(:failed_data)
+          @provisioning_data = args[:provisioning_data] if args.key?(:provisioning_data)
+          @state = args[:state] if args.key?(:state)
+          @state_initiator = args[:state_initiator] if args.key?(:state_initiator)
+          @suspended_data = args[:suspended_data] if args.key?(:suspended_data)
+          @suspending_data = args[:suspending_data] if args.key?(:suspending_data)
+        end
+      end
+      
+      # Defines the policy of the QueuedRequest.
+      class QueueingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A relative time after which resources may be created.
+        # Corresponds to the JSON property `validAfterDuration`
+        # @return [String]
+        attr_accessor :valid_after_duration
+      
+        # Optional. An absolute time after which resources may be created.
+        # Corresponds to the JSON property `validAfterTime`
+        # @return [String]
+        attr_accessor :valid_after_time
+      
+        # Represents a time interval, encoded as a Timestamp start (inclusive) and a
+        # Timestamp end (exclusive). The start must be less than or equal to the end.
+        # When the start equals the end, the interval is empty (matches no time). When
+        # both start and end are unspecified, the interval matches any time.
+        # Corresponds to the JSON property `validInterval`
+        # @return [Google::Apis::TpuV2::Interval]
+        attr_accessor :valid_interval
+      
+        # Optional. A relative time after which resources should not be created. If the
+        # request cannot be fulfilled by this time the request will be failed.
+        # Corresponds to the JSON property `validUntilDuration`
+        # @return [String]
+        attr_accessor :valid_until_duration
+      
+        # Optional. An absolute time after which resources should not be created. If the
+        # request cannot be fulfilled by this time the request will be failed.
+        # Corresponds to the JSON property `validUntilTime`
+        # @return [String]
+        attr_accessor :valid_until_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @valid_after_duration = args[:valid_after_duration] if args.key?(:valid_after_duration)
+          @valid_after_time = args[:valid_after_time] if args.key?(:valid_after_time)
+          @valid_interval = args[:valid_interval] if args.key?(:valid_interval)
+          @valid_until_duration = args[:valid_until_duration] if args.key?(:valid_until_duration)
+          @valid_until_time = args[:valid_until_time] if args.key?(:valid_until_time)
+        end
+      end
+      
+      # Request for ResetQueuedResource.
+      class ResetQueuedResourceRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A runtime version that a Node can be configured with.
       class RuntimeVersion
         include Google::Apis::Core::Hashable
@@ -888,6 +1337,12 @@ module Google
         attr_accessor :reserved
         alias_method :reserved?, :reserved
       
+        # Optional. Defines whether the node is Spot VM.
+        # Corresponds to the JSON property `spot`
+        # @return [Boolean]
+        attr_accessor :spot
+        alias_method :spot?, :spot
+      
         def initialize(**args)
            update!(**args)
         end
@@ -896,6 +1351,7 @@ module Google
         def update!(**args)
           @preemptible = args[:preemptible] if args.key?(:preemptible)
           @reserved = args[:reserved] if args.key?(:reserved)
+          @spot = args[:spot] if args.key?(:spot)
         end
       end
       
@@ -965,6 +1421,19 @@ module Google
         end
       end
       
+      # Spot tier definition.
+      class Spot
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request for StartNode.
       class StartNodeRequest
         include Google::Apis::Core::Hashable
@@ -1030,6 +1499,32 @@ module Google
         end
       end
       
+      # Further data for the suspended state.
+      class SuspendedData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Further data for the suspending state.
+      class SuspendingData
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A Symptom instance.
       class Symptom
         include Google::Apis::Core::Hashable
@@ -1066,6 +1561,25 @@ module Google
           @worker_id = args[:worker_id] if args.key?(:worker_id)
         end
       end
+      
+      # Details of the TPU resource(s) being requested.
+      class Tpu
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The TPU node(s) being requested.
+        # Corresponds to the JSON property `nodeSpec`
+        # @return [Array<Google::Apis::TpuV2::NodeSpec>]
+        attr_accessor :node_spec
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @node_spec = args[:node_spec] if args.key?(:node_spec)
+        end
+      end
     end
   end
 end

data/lib/google/apis/tpu_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module TpuV2
       # Version of the google-apis-tpu_v2 gem
-      GEM_VERSION = "0.8.0"
+      GEM_VERSION = "0.10.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230803"
+      REVISION = "20240205"
     end
   end
 end