google-api-ruby-client/generated/google-apis-genomics_v2alpha1/lib/google/apis/genomics_v2alpha1/classes.rb

1604 lines
65 KiB
Ruby

# Copyright 2020 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
require 'date'
require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'
module Google
module Apis
module GenomicsV2alpha1
# Carries information about an accelerator that can be attached to a VM.
class Accelerator
include Google::Apis::Core::Hashable
# How many accelerators of this type to attach.
# Corresponds to the JSON property `count`
# @return [Fixnum]
attr_accessor :count
# The accelerator type string (for example, "nvidia-tesla-k80"). Only NVIDIA GPU
# accelerators are currently supported. If an NVIDIA GPU is attached, the
# required runtime libraries will be made available to all containers under `/
# usr/local/nvidia`. The driver version to install must be specified using the
# NVIDIA driver version parameter on the virtual machine specification. Note
# that attaching a GPU increases the worker VM startup time by a few minutes.
# Corresponds to the JSON property `type`
# @return [String]
attr_accessor :type
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@count = args[:count] if args.key?(:count)
@type = args[:type] if args.key?(:type)
end
end
# Specifies a single action that runs a Docker container.
class Action
include Google::Apis::Core::Hashable
# If specified, overrides the `CMD` specified in the container. If the container
# also has an `ENTRYPOINT` the values are used as entrypoint arguments.
# Otherwise, they are used as a command and arguments to run inside the
# container.
# Corresponds to the JSON property `commands`
# @return [Array<String>]
attr_accessor :commands
# Holds encrypted information that is only decrypted and stored in RAM by the
# worker VM when running the pipeline.
# Corresponds to the JSON property `credentials`
# @return [Google::Apis::GenomicsV2alpha1::Secret]
attr_accessor :credentials
# If specified, overrides the `ENTRYPOINT` specified in the container.
# Corresponds to the JSON property `entrypoint`
# @return [String]
attr_accessor :entrypoint
# The environment to pass into the container. This environment is merged with
# values specified in the google.genomics.v2alpha1.Pipeline message, overwriting
# any duplicate values. In addition to the values passed here, a few other
# values are automatically injected into the environment. These cannot be hidden
# or overwritten. `GOOGLE_PIPELINE_FAILED` will be set to "1" if the pipeline
# failed because an action has exited with a non-zero status (and did not have
# the `IGNORE_EXIT_STATUS` flag set). This can be used to determine if
# additional debug or logging actions should execute. `GOOGLE_LAST_EXIT_STATUS`
# will be set to the exit status of the last non-background action that executed.
# This can be used by workflow engine authors to determine whether an
# individual action has succeeded or failed.
# Corresponds to the JSON property `environment`
# @return [Hash<String,String>]
attr_accessor :environment
# The set of flags to apply to this action.
# Corresponds to the JSON property `flags`
# @return [Array<String>]
attr_accessor :flags
# Required. The URI to pull the container image from. Note that all images
# referenced by actions in the pipeline are pulled before the first action runs.
# If multiple actions reference the same image, it is only pulled once, ensuring
# that the same image is used for all actions in a single pipeline. The image
# URI can be either a complete host and image specification (e.g., quay.io/
# biocontainers/samtools), a library and image name (e.g., google/cloud-sdk) or
# a bare image name ('bash') to pull from the default library. No schema is
# required in any of these cases. If the specified image is not public, the
# service account specified for the Virtual Machine must have access to pull the
# images from GCR, or appropriate credentials must be specified in the google.
# genomics.v2alpha1.Action.credentials field.
# Corresponds to the JSON property `imageUri`
# @return [String]
attr_accessor :image_uri
# Labels to associate with the action. This field is provided to assist workflow
# engine authors in identifying actions (for example, to indicate what sort of
# action they perform, such as localization or debugging). They are returned in
# the operation metadata, but are otherwise ignored.
# Corresponds to the JSON property `labels`
# @return [Hash<String,String>]
attr_accessor :labels
# A list of mounts to make available to the action. In addition to the values
# specified here, every action has a special virtual disk mounted under `/google`
# that contains log files and other operational components. - /google/logs All
# logs written during the pipeline execution. - /google/logs/output The combined
# standard output and standard error of all actions run as part of the pipeline
# execution. - /google/logs/action/*/stdout The complete contents of each
# individual action's standard output. - /google/logs/action/*/stderr The
# complete contents of each individual action's standard error output.
# Corresponds to the JSON property `mounts`
# @return [Array<Google::Apis::GenomicsV2alpha1::Mount>]
attr_accessor :mounts
# An optional name for the container. The container hostname will be set to this
# name, making it useful for inter-container communication. The name must
# contain only upper and lowercase alphanumeric characters and hyphens and
# cannot start with a hyphen.
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
# An optional identifier for a PID namespace to run the action inside. Multiple
# actions should use the same string to share a namespace. If unspecified, a
# separate isolated namespace is used.
# Corresponds to the JSON property `pidNamespace`
# @return [String]
attr_accessor :pid_namespace
# A map of containers to host port mappings for this container. If the container
# already specifies exposed ports, use the `PUBLISH_EXPOSED_PORTS` flag instead.
# The host port number must be less than 65536. If it is zero, an unused random
# port is assigned. To determine the resulting port number, consult the `
# ContainerStartedEvent` in the operation metadata.
# Corresponds to the JSON property `portMappings`
# @return [Hash<String,Fixnum>]
attr_accessor :port_mappings
# The maximum amount of time to give the action to complete. If the action fails
# to complete before the timeout, it will be terminated and the exit status will
# be non-zero. The pipeline will continue or terminate based on the rules
# defined by the `ALWAYS_RUN` and `IGNORE_EXIT_STATUS` flags.
# Corresponds to the JSON property `timeout`
# @return [String]
attr_accessor :timeout
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@commands = args[:commands] if args.key?(:commands)
@credentials = args[:credentials] if args.key?(:credentials)
@entrypoint = args[:entrypoint] if args.key?(:entrypoint)
@environment = args[:environment] if args.key?(:environment)
@flags = args[:flags] if args.key?(:flags)
@image_uri = args[:image_uri] if args.key?(:image_uri)
@labels = args[:labels] if args.key?(:labels)
@mounts = args[:mounts] if args.key?(:mounts)
@name = args[:name] if args.key?(:name)
@pid_namespace = args[:pid_namespace] if args.key?(:pid_namespace)
@port_mappings = args[:port_mappings] if args.key?(:port_mappings)
@timeout = args[:timeout] if args.key?(:timeout)
end
end
# The request message for Operations.CancelOperation.
class CancelOperationRequest
include Google::Apis::Core::Hashable
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
end
end
# The parameters to the CheckIn method.
class CheckInRequest
include Google::Apis::Core::Hashable
# 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.
# protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
# `Empty` is empty JSON object ````.
# Corresponds to the JSON property `deadlineExpired`
# @return [Google::Apis::GenomicsV2alpha1::Empty]
attr_accessor :deadline_expired
# A workflow specific event occurred.
# Corresponds to the JSON property `event`
# @return [Hash<String,Object>]
attr_accessor :event
# A list of timestamped events.
# Corresponds to the JSON property `events`
# @return [Array<Google::Apis::GenomicsV2alpha1::TimestampedEvent>]
attr_accessor :events
# 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 `result`
# @return [Google::Apis::GenomicsV2alpha1::Status]
attr_accessor :result
# An SOS report for an unexpected VM failure.
# Corresponds to the JSON property `sosReport`
# NOTE: Values are automatically base64 encoded/decoded in the client library.
# @return [String]
attr_accessor :sos_report
# The status of the worker VM.
# Corresponds to the JSON property `workerStatus`
# @return [Google::Apis::GenomicsV2alpha1::WorkerStatus]
attr_accessor :worker_status
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@deadline_expired = args[:deadline_expired] if args.key?(:deadline_expired)
@event = args[:event] if args.key?(:event)
@events = args[:events] if args.key?(:events)
@result = args[:result] if args.key?(:result)
@sos_report = args[:sos_report] if args.key?(:sos_report)
@worker_status = args[:worker_status] if args.key?(:worker_status)
end
end
# The response to the CheckIn method.
class CheckInResponse
include Google::Apis::Core::Hashable
# The deadline by which the worker must request an extension. The backend will
# allow for network transmission time and other delays, but the worker must
# attempt to transmit the extension request no later than the deadline.
# Corresponds to the JSON property `deadline`
# @return [String]
attr_accessor :deadline
# The metadata that describes the operation assigned to the worker.
# Corresponds to the JSON property `metadata`
# @return [Hash<String,Object>]
attr_accessor :metadata
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@deadline = args[:deadline] if args.key?(:deadline)
@metadata = args[:metadata] if args.key?(:metadata)
end
end
# Describes a Compute Engine resource that is being managed by a running
# pipeline.
class ComputeEngine
include Google::Apis::Core::Hashable
# The names of the disks that were created for this pipeline.
# Corresponds to the JSON property `diskNames`
# @return [Array<String>]
attr_accessor :disk_names
# The instance on which the operation is running.
# Corresponds to the JSON property `instanceName`
# @return [String]
attr_accessor :instance_name
# The machine type of the instance.
# Corresponds to the JSON property `machineType`
# @return [String]
attr_accessor :machine_type
# The availability zone in which the instance resides.
# Corresponds to the JSON property `zone`
# @return [String]
attr_accessor :zone
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@disk_names = args[:disk_names] if args.key?(:disk_names)
@instance_name = args[:instance_name] if args.key?(:instance_name)
@machine_type = args[:machine_type] if args.key?(:machine_type)
@zone = args[:zone] if args.key?(:zone)
end
end
# An event generated when a container is forcibly terminated by the worker.
# Currently, this only occurs when the container outlives the timeout specified
# by the user.
class ContainerKilledEvent
include Google::Apis::Core::Hashable
# The numeric ID of the action that started the container.
# Corresponds to the JSON property `actionId`
# @return [Fixnum]
attr_accessor :action_id
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@action_id = args[:action_id] if args.key?(:action_id)
end
end
# An event generated when a container starts.
class ContainerStartedEvent
include Google::Apis::Core::Hashable
# The numeric ID of the action that started this container.
# Corresponds to the JSON property `actionId`
# @return [Fixnum]
attr_accessor :action_id
# The public IP address that can be used to connect to the container. This field
# is only populated when at least one port mapping is present. If the instance
# was created with a private address, this field will be empty even if port
# mappings exist.
# Corresponds to the JSON property `ipAddress`
# @return [String]
attr_accessor :ip_address
# The container-to-host port mappings installed for this container. This set
# will contain any ports exposed using the `PUBLISH_EXPOSED_PORTS` flag as well
# as any specified in the `Action` definition.
# Corresponds to the JSON property `portMappings`
# @return [Hash<String,Fixnum>]
attr_accessor :port_mappings
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@action_id = args[:action_id] if args.key?(:action_id)
@ip_address = args[:ip_address] if args.key?(:ip_address)
@port_mappings = args[:port_mappings] if args.key?(:port_mappings)
end
end
# An event generated when a container exits.
class ContainerStoppedEvent
include Google::Apis::Core::Hashable
# The numeric ID of the action that started this container.
# Corresponds to the JSON property `actionId`
# @return [Fixnum]
attr_accessor :action_id
# The exit status of the container.
# Corresponds to the JSON property `exitStatus`
# @return [Fixnum]
attr_accessor :exit_status
# The tail end of any content written to standard error by the container. If the
# content emits large amounts of debugging noise or contains sensitive
# information, you can prevent the content from being printed by setting the `
# DISABLE_STANDARD_ERROR_CAPTURE` flag. Note that only a small amount of the end
# of the stream is captured here. The entire stream is stored in the `/google/
# logs` directory mounted into each action, and can be copied off the machine as
# described elsewhere.
# Corresponds to the JSON property `stderr`
# @return [String]
attr_accessor :stderr
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@action_id = args[:action_id] if args.key?(:action_id)
@exit_status = args[:exit_status] if args.key?(:exit_status)
@stderr = args[:stderr] if args.key?(:stderr)
end
end
# An event generated whenever a resource limitation or transient error delays
# execution of a pipeline that was otherwise ready to run.
class DelayedEvent
include Google::Apis::Core::Hashable
# A textual description of the cause of the delay. The string can change without
# notice because it is often generated by another service (such as Compute
# Engine).
# Corresponds to the JSON property `cause`
# @return [String]
attr_accessor :cause
# If the delay was caused by a resource shortage, this field lists the Compute
# Engine metrics that are preventing this operation from running (for example, `
# CPUS` or `INSTANCES`). If the particular metric is not known, a single `
# UNKNOWN` metric will be present.
# Corresponds to the JSON property `metrics`
# @return [Array<String>]
attr_accessor :metrics
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@cause = args[:cause] if args.key?(:cause)
@metrics = args[:metrics] if args.key?(:metrics)
end
end
# Carries information about a disk that can be attached to a VM. See https://
# cloud.google.com/compute/docs/disks/performance for more information about
# disk type, size, and performance considerations. Specify either `Volume` or `
# Disk`, but not both.
class Disk
include Google::Apis::Core::Hashable
# A user-supplied name for the disk. Used when mounting the disk into actions.
# The name must contain only upper and lowercase alphanumeric characters and
# hyphens and cannot start with a hyphen.
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
# The size, in GB, of the disk to attach. If the size is not specified, a
# default is chosen to ensure reasonable I/O performance. If the disk type is
# specified as `local-ssd`, multiple local drives are automatically combined to
# provide the requested size. Note, however, that each physical SSD is 375GB in
# size, and no more than 8 drives can be attached to a single instance.
# Corresponds to the JSON property `sizeGb`
# @return [Fixnum]
attr_accessor :size_gb
# An optional image to put on the disk before attaching it to the VM.
# Corresponds to the JSON property `sourceImage`
# @return [String]
attr_accessor :source_image
# The Compute Engine disk type. If unspecified, `pd-standard` is used.
# Corresponds to the JSON property `type`
# @return [String]
attr_accessor :type
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@name = args[:name] if args.key?(:name)
@size_gb = args[:size_gb] if args.key?(:size_gb)
@source_image = args[:source_image] if args.key?(:source_image)
@type = args[:type] if args.key?(:type)
end
end
# The status of a disk on a VM.
class DiskStatus
include Google::Apis::Core::Hashable
# Free disk space.
# Corresponds to the JSON property `freeSpaceBytes`
# @return [Fixnum]
attr_accessor :free_space_bytes
# Total disk space.
# Corresponds to the JSON property `totalSpaceBytes`
# @return [Fixnum]
attr_accessor :total_space_bytes
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@free_space_bytes = args[:free_space_bytes] if args.key?(:free_space_bytes)
@total_space_bytes = args[:total_space_bytes] if args.key?(:total_space_bytes)
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.
# protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
# `Empty` is empty JSON object ````.
class Empty
include Google::Apis::Core::Hashable
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
end
end
# Carries information about events that occur during pipeline execution.
class Event
include Google::Apis::Core::Hashable
# A human-readable description of the event. Note that these strings can change
# at any time without notice. Any application logic must use the information in
# the `details` field.
# Corresponds to the JSON property `description`
# @return [String]
attr_accessor :description
# Machine-readable details about the event.
# Corresponds to the JSON property `details`
# @return [Hash<String,Object>]
attr_accessor :details
# The time at which the event occurred.
# Corresponds to the JSON property `timestamp`
# @return [String]
attr_accessor :timestamp
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@description = args[:description] if args.key?(:description)
@details = args[:details] if args.key?(:details)
@timestamp = args[:timestamp] if args.key?(:timestamp)
end
end
# Configuration for an existing disk to be attached to the VM.
class ExistingDisk
include Google::Apis::Core::Hashable
# If `disk` contains slashes, the Cloud Life Sciences API assumes that it is a
# complete URL for the disk. If `disk` does not contain slashes, the Cloud Life
# Sciences API assumes that the disk is a zonal disk and a URL will be generated
# of the form `zones//disks/`, where `` is the zone in which the instance is
# allocated. The disk must be ext4 formatted. If all `Mount` references to this
# disk have the `read_only` flag set to true, the disk will be attached in `read-
# only` mode and can be shared with other instances. Otherwise, the disk will be
# available for writing but cannot be shared.
# Corresponds to the JSON property `disk`
# @return [String]
attr_accessor :disk
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@disk = args[:disk] if args.key?(:disk)
end
end
# An event generated when the execution of a pipeline has failed. Note that
# other events can continue to occur after this event.
class FailedEvent
include Google::Apis::Core::Hashable
# The human-readable description of the cause of the failure.
# Corresponds to the JSON property `cause`
# @return [String]
attr_accessor :cause
# The Google standard error code that best describes this failure.
# Corresponds to the JSON property `code`
# @return [String]
attr_accessor :code
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@cause = args[:cause] if args.key?(:cause)
@code = args[:code] if args.key?(:code)
end
end
# The response message for Operations.ListOperations.
class ListOperationsResponse
include Google::Apis::Core::Hashable
# The standard List next-page token.
# Corresponds to the JSON property `nextPageToken`
# @return [String]
attr_accessor :next_page_token
# A list of operations that matches the specified filter in the request.
# Corresponds to the JSON property `operations`
# @return [Array<Google::Apis::GenomicsV2alpha1::Operation>]
attr_accessor :operations
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)
@operations = args[:operations] if args.key?(:operations)
end
end
# Carries information about the pipeline execution that is returned in the long
# running operation's metadata field.
class Metadata
include Google::Apis::Core::Hashable
# The time at which the operation was created by the API.
# Corresponds to the JSON property `createTime`
# @return [String]
attr_accessor :create_time
# The time at which execution was completed and resources were cleaned up.
# Corresponds to the JSON property `endTime`
# @return [String]
attr_accessor :end_time
# The list of events that have happened so far during the execution of this
# operation.
# Corresponds to the JSON property `events`
# @return [Array<Google::Apis::GenomicsV2alpha1::Event>]
attr_accessor :events
# The user-defined labels associated with this operation.
# Corresponds to the JSON property `labels`
# @return [Hash<String,String>]
attr_accessor :labels
# Specifies a series of actions to execute, expressed as Docker containers.
# Corresponds to the JSON property `pipeline`
# @return [Google::Apis::GenomicsV2alpha1::Pipeline]
attr_accessor :pipeline
# The first time at which resources were allocated to execute the pipeline.
# 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)
@create_time = args[:create_time] if args.key?(:create_time)
@end_time = args[:end_time] if args.key?(:end_time)
@events = args[:events] if args.key?(:events)
@labels = args[:labels] if args.key?(:labels)
@pipeline = args[:pipeline] if args.key?(:pipeline)
@start_time = args[:start_time] if args.key?(:start_time)
end
end
# Carries information about a particular disk mount inside a container.
class Mount
include Google::Apis::Core::Hashable
# The name of the disk to mount, as specified in the resources section.
# Corresponds to the JSON property `disk`
# @return [String]
attr_accessor :disk
# The path to mount the disk inside the container.
# Corresponds to the JSON property `path`
# @return [String]
attr_accessor :path
# If true, the disk is mounted read-only inside the container.
# Corresponds to the JSON property `readOnly`
# @return [Boolean]
attr_accessor :read_only
alias_method :read_only?, :read_only
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@disk = args[:disk] if args.key?(:disk)
@path = args[:path] if args.key?(:path)
@read_only = args[:read_only] if args.key?(:read_only)
end
end
# Configuration for an `NFSMount` to be attached to the VM.
class NfsMount
include Google::Apis::Core::Hashable
# A target NFS mount. The target must be specified as `address:/mount".
# Corresponds to the JSON property `target`
# @return [String]
attr_accessor :target
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@target = args[:target] if args.key?(:target)
end
end
# VM networking options.
class Network
include Google::Apis::Core::Hashable
# The network name to attach the VM's network interface to. The value will be
# prefixed with `global/networks/` unless it contains a `/`, in which case it is
# assumed to be a fully specified network resource URL. If unspecified, the
# global default network is used.
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
# If the specified network is configured for custom subnet creation, the name of
# the subnetwork to attach the instance to must be specified here. The value is
# prefixed with `regions/*/subnetworks/` unless it contains a `/`, in which case
# it is assumed to be a fully specified subnetwork resource URL. If the `*`
# character appears in the value, it is replaced with the region that the
# virtual machine has been allocated in.
# Corresponds to the JSON property `subnetwork`
# @return [String]
attr_accessor :subnetwork
# If set to true, do not attach a public IP address to the VM. Note that without
# a public IP address, additional configuration is required to allow the VM to
# access Google services. See https://cloud.google.com/vpc/docs/configure-
# private-google-access for more information.
# Corresponds to the JSON property `usePrivateAddress`
# @return [Boolean]
attr_accessor :use_private_address
alias_method :use_private_address?, :use_private_address
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@name = args[:name] if args.key?(:name)
@subnetwork = args[:subnetwork] if args.key?(:subnetwork)
@use_private_address = args[:use_private_address] if args.key?(:use_private_address)
end
end
# This resource represents a long-running operation that is the result of a
# network API call.
class Operation
include Google::Apis::Core::Hashable
# If the value is `false`, it means the operation is still in progress. If `true`
# , the operation is completed, and either `error` or `response` is available.
# Corresponds to the JSON property `done`
# @return [Boolean]
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). 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::GenomicsV2alpha1::Status]
attr_accessor :error
# An OperationMetadata or Metadata object. This will always be returned with the
# Operation.
# Corresponds to the JSON property `metadata`
# @return [Hash<String,Object>]
attr_accessor :metadata
# The server-assigned name, which is only unique within the same service that
# originally returns it. For example: `operations/CJHU7Oi_ChDrveSpBRjfuL-
# qzoWAgEw`
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
# An Empty object.
# Corresponds to the JSON property `response`
# @return [Hash<String,Object>]
attr_accessor :response
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@done = args[:done] if args.key?(:done)
@error = args[:error] if args.key?(:error)
@metadata = args[:metadata] if args.key?(:metadata)
@name = args[:name] if args.key?(:name)
@response = args[:response] if args.key?(:response)
end
end
# An event that occurred during an Operation.
class OperationEvent
include Google::Apis::Core::Hashable
# Required description of event.
# Corresponds to the JSON property `description`
# @return [String]
attr_accessor :description
# Optional time of when event finished. An event can have a start time and no
# finish time. If an event has a finish time, there must be a start time.
# Corresponds to the JSON property `endTime`
# @return [String]
attr_accessor :end_time
# Optional time of when event started.
# 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)
@description = args[:description] if args.key?(:description)
@end_time = args[:end_time] if args.key?(:end_time)
@start_time = args[:start_time] if args.key?(:start_time)
end
end
# Metadata describing an Operation.
class OperationMetadata
include Google::Apis::Core::Hashable
# This field is deprecated. Use `labels` instead. Optionally provided by the
# caller when submitting the request that creates the operation.
# Corresponds to the JSON property `clientId`
# @return [String]
attr_accessor :client_id
# The time at which the job was submitted to the Genomics service.
# Corresponds to the JSON property `createTime`
# @return [String]
attr_accessor :create_time
# The time at which the job stopped running.
# Corresponds to the JSON property `endTime`
# @return [String]
attr_accessor :end_time
# Optional event messages that were generated during the job's execution. This
# also contains any warnings that were generated during import or export.
# Corresponds to the JSON property `events`
# @return [Array<Google::Apis::GenomicsV2alpha1::OperationEvent>]
attr_accessor :events
# Optionally provided by the caller when submitting the request that creates the
# operation.
# Corresponds to the JSON property `labels`
# @return [Hash<String,String>]
attr_accessor :labels
# The Google Cloud Project in which the job is scoped.
# Corresponds to the JSON property `projectId`
# @return [String]
attr_accessor :project_id
# The original request that started the operation. Note that this will be in
# current version of the API. If the operation was started with v1beta2 API and
# a GetOperation is performed on v1 API, a v1 request will be returned.
# Corresponds to the JSON property `request`
# @return [Hash<String,Object>]
attr_accessor :request
# Runtime metadata on this Operation.
# Corresponds to the JSON property `runtimeMetadata`
# @return [Hash<String,Object>]
attr_accessor :runtime_metadata
# The time at which the job began to run.
# 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)
@client_id = args[:client_id] if args.key?(:client_id)
@create_time = args[:create_time] if args.key?(:create_time)
@end_time = args[:end_time] if args.key?(:end_time)
@events = args[:events] if args.key?(:events)
@labels = args[:labels] if args.key?(:labels)
@project_id = args[:project_id] if args.key?(:project_id)
@request = args[:request] if args.key?(:request)
@runtime_metadata = args[:runtime_metadata] if args.key?(:runtime_metadata)
@start_time = args[:start_time] if args.key?(:start_time)
end
end
# Configuration for a persistent disk to be attached to the VM. See https://
# cloud.google.com/compute/docs/disks/performance for more information about
# disk type, size, and performance considerations.
class PersistentDisk
include Google::Apis::Core::Hashable
# The size, in GB, of the disk to attach. If the size is not specified, a
# default is chosen to ensure reasonable I/O performance. If the disk type is
# specified as `local-ssd`, multiple local drives are automatically combined to
# provide the requested size. Note, however, that each physical SSD is 375GB in
# size, and no more than 8 drives can be attached to a single instance.
# Corresponds to the JSON property `sizeGb`
# @return [Fixnum]
attr_accessor :size_gb
# An image to put on the disk before attaching it to the VM.
# Corresponds to the JSON property `sourceImage`
# @return [String]
attr_accessor :source_image
# The Compute Engine disk type. If unspecified, `pd-standard` is used.
# Corresponds to the JSON property `type`
# @return [String]
attr_accessor :type
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@size_gb = args[:size_gb] if args.key?(:size_gb)
@source_image = args[:source_image] if args.key?(:source_image)
@type = args[:type] if args.key?(:type)
end
end
# Specifies a series of actions to execute, expressed as Docker containers.
class Pipeline
include Google::Apis::Core::Hashable
# The list of actions to execute, in the order they are specified.
# Corresponds to the JSON property `actions`
# @return [Array<Google::Apis::GenomicsV2alpha1::Action>]
attr_accessor :actions
# The environment to pass into every action. Each action can also specify
# additional environment variables but cannot delete an entry from this map (
# though they can overwrite it with a different value).
# Corresponds to the JSON property `environment`
# @return [Hash<String,String>]
attr_accessor :environment
# The system resources for the pipeline run. At least one zone or region must be
# specified or the pipeline run will fail.
# Corresponds to the JSON property `resources`
# @return [Google::Apis::GenomicsV2alpha1::Resources]
attr_accessor :resources
# The maximum amount of time to give the pipeline to complete. This includes the
# time spent waiting for a worker to be allocated. If the pipeline fails to
# complete before the timeout, it will be cancelled and the error code will be
# set to DEADLINE_EXCEEDED. If unspecified, it will default to 7 days.
# Corresponds to the JSON property `timeout`
# @return [String]
attr_accessor :timeout
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@actions = args[:actions] if args.key?(:actions)
@environment = args[:environment] if args.key?(:environment)
@resources = args[:resources] if args.key?(:resources)
@timeout = args[:timeout] if args.key?(:timeout)
end
end
# An event generated when the worker starts pulling an image.
class PullStartedEvent
include Google::Apis::Core::Hashable
# The URI of the image that was pulled.
# Corresponds to the JSON property `imageUri`
# @return [String]
attr_accessor :image_uri
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@image_uri = args[:image_uri] if args.key?(:image_uri)
end
end
# An event generated when the worker stops pulling an image.
class PullStoppedEvent
include Google::Apis::Core::Hashable
# The URI of the image that was pulled.
# Corresponds to the JSON property `imageUri`
# @return [String]
attr_accessor :image_uri
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@image_uri = args[:image_uri] if args.key?(:image_uri)
end
end
# The system resources for the pipeline run. At least one zone or region must be
# specified or the pipeline run will fail.
class Resources
include Google::Apis::Core::Hashable
# The project ID to allocate resources in.
# Corresponds to the JSON property `projectId`
# @return [String]
attr_accessor :project_id
# The list of regions allowed for VM allocation. If set, the `zones` field must
# not be set.
# Corresponds to the JSON property `regions`
# @return [Array<String>]
attr_accessor :regions
# Carries information about a Compute Engine VM resource.
# Corresponds to the JSON property `virtualMachine`
# @return [Google::Apis::GenomicsV2alpha1::VirtualMachine]
attr_accessor :virtual_machine
# The list of zones allowed for VM allocation. If set, the `regions` field must
# not be set.
# Corresponds to the JSON property `zones`
# @return [Array<String>]
attr_accessor :zones
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@project_id = args[:project_id] if args.key?(:project_id)
@regions = args[:regions] if args.key?(:regions)
@virtual_machine = args[:virtual_machine] if args.key?(:virtual_machine)
@zones = args[:zones] if args.key?(:zones)
end
end
# The arguments to the `RunPipeline` method. The requesting user must have the `
# iam.serviceAccounts.actAs` permission for the Cloud Genomics service account
# or the request will fail.
class RunPipelineRequest
include Google::Apis::Core::Hashable
# User-defined labels to associate with the returned operation. These labels are
# not propagated to any Google Cloud Platform resources used by the operation,
# and can be modified at any time. To associate labels with resources created
# while executing the operation, see the appropriate resource message (for
# example, `VirtualMachine`).
# Corresponds to the JSON property `labels`
# @return [Hash<String,String>]
attr_accessor :labels
# Specifies a series of actions to execute, expressed as Docker containers.
# Corresponds to the JSON property `pipeline`
# @return [Google::Apis::GenomicsV2alpha1::Pipeline]
attr_accessor :pipeline
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@labels = args[:labels] if args.key?(:labels)
@pipeline = args[:pipeline] if args.key?(:pipeline)
end
end
# The response to the RunPipeline method, returned in the operation's result
# field on success.
class RunPipelineResponse
include Google::Apis::Core::Hashable
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
end
end
# Runtime metadata that will be populated in the runtimeMetadata field of the
# Operation associated with a RunPipeline execution.
class RuntimeMetadata
include Google::Apis::Core::Hashable
# Describes a Compute Engine resource that is being managed by a running
# pipeline.
# Corresponds to the JSON property `computeEngine`
# @return [Google::Apis::GenomicsV2alpha1::ComputeEngine]
attr_accessor :compute_engine
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@compute_engine = args[:compute_engine] if args.key?(:compute_engine)
end
end
# Holds encrypted information that is only decrypted and stored in RAM by the
# worker VM when running the pipeline.
class Secret
include Google::Apis::Core::Hashable
# The value of the cipherText response from the `encrypt` method. This field is
# intentionally unaudited.
# Corresponds to the JSON property `cipherText`
# @return [String]
attr_accessor :cipher_text
# The name of the Cloud KMS key that will be used to decrypt the secret value.
# The VM service account must have the required permissions and authentication
# scopes to invoke the `decrypt` method on the specified key.
# Corresponds to the JSON property `keyName`
# @return [String]
attr_accessor :key_name
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@cipher_text = args[:cipher_text] if args.key?(:cipher_text)
@key_name = args[:key_name] if args.key?(:key_name)
end
end
# Carries information about a Google Cloud service account.
class ServiceAccount
include Google::Apis::Core::Hashable
# Email address of the service account. If not specified, the default Compute
# Engine service account for the project will be used.
# Corresponds to the JSON property `email`
# @return [String]
attr_accessor :email
# List of scopes to be enabled for this service account on the VM, in addition
# to the cloud-platform API scope that will be added by default.
# Corresponds to the JSON property `scopes`
# @return [Array<String>]
attr_accessor :scopes
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@email = args[:email] if args.key?(:email)
@scopes = args[:scopes] if args.key?(:scopes)
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). 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).
class Status
include Google::Apis::Core::Hashable
# The status code, which should be an enum value of google.rpc.Code.
# Corresponds to the JSON property `code`
# @return [Fixnum]
attr_accessor :code
# A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
# Corresponds to the JSON property `details`
# @return [Array<Hash<String,Object>>]
attr_accessor :details
# A developer-facing error message, which should be in English. Any user-facing
# error message should be localized and sent in the google.rpc.Status.details
# field, or localized by the client.
# Corresponds to the JSON property `message`
# @return [String]
attr_accessor :message
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@code = args[:code] if args.key?(:code)
@details = args[:details] if args.key?(:details)
@message = args[:message] if args.key?(:message)
end
end
# An event that occured in the operation assigned to the worker and the time of
# occurance.
class TimestampedEvent
include Google::Apis::Core::Hashable
# The event data.
# Corresponds to the JSON property `data`
# @return [Hash<String,Object>]
attr_accessor :data
# The time when the event happened.
# Corresponds to the JSON property `timestamp`
# @return [String]
attr_accessor :timestamp
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@data = args[:data] if args.key?(:data)
@timestamp = args[:timestamp] if args.key?(:timestamp)
end
end
# An event generated when the execution of a container results in a non-zero
# exit status that was not otherwise ignored. Execution will continue, but only
# actions that are flagged as `ALWAYS_RUN` will be executed. Other actions will
# be skipped.
class UnexpectedExitStatusEvent
include Google::Apis::Core::Hashable
# The numeric ID of the action that started the container.
# Corresponds to the JSON property `actionId`
# @return [Fixnum]
attr_accessor :action_id
# The exit status of the container.
# Corresponds to the JSON property `exitStatus`
# @return [Fixnum]
attr_accessor :exit_status
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@action_id = args[:action_id] if args.key?(:action_id)
@exit_status = args[:exit_status] if args.key?(:exit_status)
end
end
# Carries information about a Compute Engine VM resource.
class VirtualMachine
include Google::Apis::Core::Hashable
# The list of accelerators to attach to the VM.
# Corresponds to the JSON property `accelerators`
# @return [Array<Google::Apis::GenomicsV2alpha1::Accelerator>]
attr_accessor :accelerators
# The size of the boot disk, in GB. The boot disk must be large enough to
# accommodate all of the Docker images from each action in the pipeline at the
# same time. If not specified, a small but reasonable default value is used.
# Corresponds to the JSON property `bootDiskSizeGb`
# @return [Fixnum]
attr_accessor :boot_disk_size_gb
# The host operating system image to use. Currently, only Container-Optimized OS
# images can be used. The default value is `projects/cos-cloud/global/images/
# family/cos-stable`, which selects the latest stable release of Container-
# Optimized OS. This option is provided to allow testing against the beta
# release of the operating system to ensure that the new version does not
# interact negatively with production pipelines. To test a pipeline against the
# beta release of Container-Optimized OS, use the value `projects/cos-cloud/
# global/images/family/cos-beta`.
# Corresponds to the JSON property `bootImage`
# @return [String]
attr_accessor :boot_image
# The CPU platform to request. An instance based on a newer platform can be
# allocated, but never one with fewer capabilities. The value of this parameter
# must be a valid Compute Engine CPU platform name (such as "Intel Skylake").
# This parameter is only useful for carefully optimized work loads where the CPU
# platform has a significant impact. For more information about the effect of
# this parameter, see https://cloud.google.com/compute/docs/instances/specify-
# min-cpu-platform.
# Corresponds to the JSON property `cpuPlatform`
# @return [String]
attr_accessor :cpu_platform
# The list of disks to create and attach to the VM. Specify either the `volumes[]
# ` field or the `disks[]` field, but not both.
# Corresponds to the JSON property `disks`
# @return [Array<Google::Apis::GenomicsV2alpha1::Disk>]
attr_accessor :disks
# The Compute Engine Disk Images to use as a Docker cache. The disks will be
# mounted into the Docker folder in a way that the images present in the cache
# will not need to be pulled. The digests of the cached images must match those
# of the tags used or the latest version will still be pulled. The root
# directory of the ext4 image must contain `image` and `overlay2` directories
# copied from the Docker directory of a VM where the desired Docker images have
# already been pulled. Any images pulled that are not cached will be stored on
# the first cache disk instead of the boot disk. Only a single image is
# supported.
# Corresponds to the JSON property `dockerCacheImages`
# @return [Array<String>]
attr_accessor :docker_cache_images
# Whether Stackdriver monitoring should be enabled on the VM.
# Corresponds to the JSON property `enableStackdriverMonitoring`
# @return [Boolean]
attr_accessor :enable_stackdriver_monitoring
alias_method :enable_stackdriver_monitoring?, :enable_stackdriver_monitoring
# Optional set of labels to apply to the VM and any attached disk resources.
# These labels must adhere to the [name and value restrictions](https://cloud.
# google.com/compute/docs/labeling-resources) on VM labels imposed by Compute
# Engine. Labels keys with the prefix 'google-' are reserved for use by Google.
# Labels applied at creation time to the VM. Applied on a best-effort basis to
# attached disk resources shortly after VM creation.
# Corresponds to the JSON property `labels`
# @return [Hash<String,String>]
attr_accessor :labels
# Required. The machine type of the virtual machine to create. Must be the short
# name of a standard machine type (such as "n1-standard-1") or a custom machine
# type (such as "custom-1-4096", where "1" indicates the number of vCPUs and "
# 4096" indicates the memory in MB). See [Creating an instance with a custom
# machine type](https://cloud.google.com/compute/docs/instances/creating-
# instance-with-custom-machine-type#create) for more specifications on creating
# a custom machine type.
# Corresponds to the JSON property `machineType`
# @return [String]
attr_accessor :machine_type
# VM networking options.
# Corresponds to the JSON property `network`
# @return [Google::Apis::GenomicsV2alpha1::Network]
attr_accessor :network
# The NVIDIA driver version to use when attaching an NVIDIA GPU accelerator. The
# version specified here must be compatible with the GPU libraries contained in
# the container being executed, and must be one of the drivers hosted in the `
# nvidia-drivers-us-public` bucket on Google Cloud Storage.
# Corresponds to the JSON property `nvidiaDriverVersion`
# @return [String]
attr_accessor :nvidia_driver_version
# If true, allocate a preemptible VM.
# Corresponds to the JSON property `preemptible`
# @return [Boolean]
attr_accessor :preemptible
alias_method :preemptible?, :preemptible
# Carries information about a Google Cloud service account.
# Corresponds to the JSON property `serviceAccount`
# @return [Google::Apis::GenomicsV2alpha1::ServiceAccount]
attr_accessor :service_account
# The list of disks and other storage to create or attach to the VM. Specify
# either the `volumes[]` field or the `disks[]` field, but not both.
# Corresponds to the JSON property `volumes`
# @return [Array<Google::Apis::GenomicsV2alpha1::Volume>]
attr_accessor :volumes
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@accelerators = args[:accelerators] if args.key?(:accelerators)
@boot_disk_size_gb = args[:boot_disk_size_gb] if args.key?(:boot_disk_size_gb)
@boot_image = args[:boot_image] if args.key?(:boot_image)
@cpu_platform = args[:cpu_platform] if args.key?(:cpu_platform)
@disks = args[:disks] if args.key?(:disks)
@docker_cache_images = args[:docker_cache_images] if args.key?(:docker_cache_images)
@enable_stackdriver_monitoring = args[:enable_stackdriver_monitoring] if args.key?(:enable_stackdriver_monitoring)
@labels = args[:labels] if args.key?(:labels)
@machine_type = args[:machine_type] if args.key?(:machine_type)
@network = args[:network] if args.key?(:network)
@nvidia_driver_version = args[:nvidia_driver_version] if args.key?(:nvidia_driver_version)
@preemptible = args[:preemptible] if args.key?(:preemptible)
@service_account = args[:service_account] if args.key?(:service_account)
@volumes = args[:volumes] if args.key?(:volumes)
end
end
# Carries information about storage that can be attached to a VM. Specify either
# `Volume` or `Disk`, but not both.
class Volume
include Google::Apis::Core::Hashable
# Configuration for an existing disk to be attached to the VM.
# Corresponds to the JSON property `existingDisk`
# @return [Google::Apis::GenomicsV2alpha1::ExistingDisk]
attr_accessor :existing_disk
# Configuration for an `NFSMount` to be attached to the VM.
# Corresponds to the JSON property `nfsMount`
# @return [Google::Apis::GenomicsV2alpha1::NfsMount]
attr_accessor :nfs_mount
# Configuration for a persistent disk to be attached to the VM. See https://
# cloud.google.com/compute/docs/disks/performance for more information about
# disk type, size, and performance considerations.
# Corresponds to the JSON property `persistentDisk`
# @return [Google::Apis::GenomicsV2alpha1::PersistentDisk]
attr_accessor :persistent_disk
# A user-supplied name for the volume. Used when mounting the volume into `
# Actions`. The name must contain only upper and lowercase alphanumeric
# characters and hyphens and cannot start with a hyphen.
# Corresponds to the JSON property `volume`
# @return [String]
attr_accessor :volume
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@existing_disk = args[:existing_disk] if args.key?(:existing_disk)
@nfs_mount = args[:nfs_mount] if args.key?(:nfs_mount)
@persistent_disk = args[:persistent_disk] if args.key?(:persistent_disk)
@volume = args[:volume] if args.key?(:volume)
end
end
# An event generated after a worker VM has been assigned to run the pipeline.
class WorkerAssignedEvent
include Google::Apis::Core::Hashable
# The worker's instance name.
# Corresponds to the JSON property `instance`
# @return [String]
attr_accessor :instance
# The machine type that was assigned for the worker.
# Corresponds to the JSON property `machineType`
# @return [String]
attr_accessor :machine_type
# The zone the worker is running in.
# Corresponds to the JSON property `zone`
# @return [String]
attr_accessor :zone
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@instance = args[:instance] if args.key?(:instance)
@machine_type = args[:machine_type] if args.key?(:machine_type)
@zone = args[:zone] if args.key?(:zone)
end
end
# An event generated when the worker VM that was assigned to the pipeline has
# been released (deleted).
class WorkerReleasedEvent
include Google::Apis::Core::Hashable
# The worker's instance name.
# Corresponds to the JSON property `instance`
# @return [String]
attr_accessor :instance
# The zone the worker was running in.
# Corresponds to the JSON property `zone`
# @return [String]
attr_accessor :zone
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@instance = args[:instance] if args.key?(:instance)
@zone = args[:zone] if args.key?(:zone)
end
end
# The status of the worker VM.
class WorkerStatus
include Google::Apis::Core::Hashable
# Status of attached disks.
# Corresponds to the JSON property `attachedDisks`
# @return [Hash<String,Google::Apis::GenomicsV2alpha1::DiskStatus>]
attr_accessor :attached_disks
# The status of a disk on a VM.
# Corresponds to the JSON property `bootDisk`
# @return [Google::Apis::GenomicsV2alpha1::DiskStatus]
attr_accessor :boot_disk
# Free RAM.
# Corresponds to the JSON property `freeRamBytes`
# @return [Fixnum]
attr_accessor :free_ram_bytes
# Total RAM.
# Corresponds to the JSON property `totalRamBytes`
# @return [Fixnum]
attr_accessor :total_ram_bytes
# System uptime.
# Corresponds to the JSON property `uptimeSeconds`
# @return [Fixnum]
attr_accessor :uptime_seconds
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@attached_disks = args[:attached_disks] if args.key?(:attached_disks)
@boot_disk = args[:boot_disk] if args.key?(:boot_disk)
@free_ram_bytes = args[:free_ram_bytes] if args.key?(:free_ram_bytes)
@total_ram_bytes = args[:total_ram_bytes] if args.key?(:total_ram_bytes)
@uptime_seconds = args[:uptime_seconds] if args.key?(:uptime_seconds)
end
end
end
end
end