Class: Google::Cloud::Dataproc::V1beta2::InstanceGroupConfig

Inherits:
Object
  • Object
show all
Extended by:
Protobuf::MessageExts::ClassMethods
Includes:
Protobuf::MessageExts
Defined in:
proto_docs/google/cloud/dataproc/v1beta2/clusters.rb

Overview

The config settings for Compute Engine resources in an instance group, such as a master or worker group.

Defined Under Namespace

Modules: Preemptibility

Instance Attribute Summary collapse

Instance Attribute Details

#accelerators ⇒ ::Array<::Google::Cloud::Dataproc::V1beta2::AcceleratorConfig>

Returns Optional. The Compute Engine accelerator configuration for these instances.

Returns:



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#disk_config ⇒ ::Google::Cloud::Dataproc::V1beta2::DiskConfig

Returns Optional. Disk option config settings.

Returns:



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#image_uri ⇒ ::String

Returns Optional. The Compute Engine image resource used for cluster instances.

The URI can represent an image or image family.

Image examples:

  • https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]
  • projects/[project_id]/global/images/[image-id]
  • image-id

Image family examples. Dataproc will use the most recent image from the family:

  • https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]
  • projects/[project_id]/global/images/family/[custom-image-family-name]

If the URI is unspecified, it will be inferred from SoftwareConfig.image_version or the system default.

Returns:

  • (::String) —

    Optional. The Compute Engine image resource used for cluster instances.

    The URI can represent an image or image family.

    Image examples:

    • https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]
    • projects/[project_id]/global/images/[image-id]
    • image-id

    Image family examples. Dataproc will use the most recent image from the family:

    • https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]
    • projects/[project_id]/global/images/family/[custom-image-family-name]

    If the URI is unspecified, it will be inferred from SoftwareConfig.image_version or the system default.



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#instance_names ⇒ ::Array<::String> (readonly)

Returns Output only. The list of instance names. Dataproc derives the names from cluster_name, num_instances, and the instance group.

Returns:

  • (::Array<::String>) —

    Output only. The list of instance names. Dataproc derives the names from cluster_name, num_instances, and the instance group.



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#is_preemptible ⇒ ::Boolean (readonly)

Returns Output only. Specifies that this instance group contains preemptible instances.

Returns:

  • (::Boolean) —

    Output only. Specifies that this instance group contains preemptible instances.



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#machine_type_uri ⇒ ::String

Returns Optional. The Compute Engine machine type used for cluster instances.

A full URL, partial URI, or short name are valid. Examples:

  • https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
  • projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
  • n1-standard-2

Auto Zone Exception: If you are using the Dataproc Auto Zone Placement feature, you must use the short name of the machine type resource, for example, n1-standard-2.

Returns:

  • (::String) —

    Optional. The Compute Engine machine type used for cluster instances.

    A full URL, partial URI, or short name are valid. Examples:

    • https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
    • projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
    • n1-standard-2

    Auto Zone Exception: If you are using the Dataproc Auto Zone Placement feature, you must use the short name of the machine type resource, for example, n1-standard-2.



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#managed_group_config ⇒ ::Google::Cloud::Dataproc::V1beta2::ManagedGroupConfig (readonly)

Returns Output only. The config for Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.

Returns:



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#min_cpu_platform ⇒ ::String

Returns Specifies the minimum cpu platform for the Instance Group. See Dataproc -> Minimum CPU Platform.

Returns:



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#num_instances ⇒ ::Integer

Returns Optional. The number of VM instances in the instance group. For master instance groups, must be set to 1.

Returns:

  • (::Integer) —

    Optional. The number of VM instances in the instance group. For master instance groups, must be set to 1.



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end

#preemptibility ⇒ ::Google::Cloud::Dataproc::V1beta2::InstanceGroupConfig::Preemptibility

Returns Optional. Specifies the preemptibility of the instance group.

The default value for master and worker groups is NON_PREEMPTIBLE. This default cannot be changed.

The default value for secondary instances is PREEMPTIBLE.

Returns:



407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'proto_docs/google/cloud/dataproc/v1beta2/clusters.rb', line 407

class InstanceGroupConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Controls the use of
  # [preemptible instances]
  # (https://cloud.google.com/compute/docs/instances/preemptible)
  # within the group.
  module Preemptibility
    # Preemptibility is unspecified, the system will choose the
    # appropriate setting for each instance group.
    PREEMPTIBILITY_UNSPECIFIED = 0

    # Instances are non-preemptible.
    #
    # This option is allowed for all instance groups and is the only valid
    # value for Master and Worker instance groups.
    NON_PREEMPTIBLE = 1

    # Instances are preemptible.
    #
    # This option is allowed only for secondary worker groups.
    PREEMPTIBLE = 2
  end
end