Cloud Dataproc V1 API - Class Google::Cloud::Dataproc::V1::InstanceGroupConfig (v1.1.0)

Reference documentation and code samples for the Cloud Dataproc V1 API class Google::Cloud::Dataproc::V1::InstanceGroupConfig.

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

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#accelerators

def accelerators() -> ::Array<::Google::Cloud::Dataproc::V1::AcceleratorConfig>
Returns

#accelerators=

def accelerators=(value) -> ::Array<::Google::Cloud::Dataproc::V1::AcceleratorConfig>
Parameter
Returns

#disk_config

def disk_config() -> ::Google::Cloud::Dataproc::V1::DiskConfig
Returns

#disk_config=

def disk_config=(value) -> ::Google::Cloud::Dataproc::V1::DiskConfig
Parameter
Returns

#image_uri

def image_uri() -> ::String
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/v1/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/v1/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.

#image_uri=

def image_uri=(value) -> ::String
Parameter
  • value (::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/v1/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/v1/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/v1/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/v1/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.

#instance_flexibility_policy

def instance_flexibility_policy() -> ::Google::Cloud::Dataproc::V1::InstanceFlexibilityPolicy
Returns

#instance_flexibility_policy=

def instance_flexibility_policy=(value) -> ::Google::Cloud::Dataproc::V1::InstanceFlexibilityPolicy
Parameter
Returns

#instance_names

def instance_names() -> ::Array<::String>
Returns
  • (::Array<::String>) — Output only. The list of instance names. Dataproc derives the names from cluster_name, num_instances, and the instance group.

#instance_references

def instance_references() -> ::Array<::Google::Cloud::Dataproc::V1::InstanceReference>
Returns

#is_preemptible

def is_preemptible() -> ::Boolean
Returns
  • (::Boolean) — Output only. Specifies that this instance group contains preemptible instances.

#machine_type_uri

def machine_type_uri() -> ::String
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/[zone]/machineTypes/n1-standard-2
    • projects/[project_id]/zones/[zone]/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.

#machine_type_uri=

def machine_type_uri=(value) -> ::String
Parameter
  • value (::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/[zone]/machineTypes/n1-standard-2
    • projects/[project_id]/zones/[zone]/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/[zone]/machineTypes/n1-standard-2
    • projects/[project_id]/zones/[zone]/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.

#managed_group_config

def managed_group_config() -> ::Google::Cloud::Dataproc::V1::ManagedGroupConfig
Returns

#min_cpu_platform

def min_cpu_platform() -> ::String
Returns

#min_cpu_platform=

def min_cpu_platform=(value) -> ::String
Parameter
Returns

#min_num_instances

def min_num_instances() -> ::Integer
Returns
  • (::Integer) —

    Optional. The minimum number of primary worker instances to create. If min_num_instances is set, cluster creation will succeed if the number of primary workers created is at least equal to the min_num_instances number.

    Example: Cluster creation request with num_instances = 5 and min_num_instances = 3:

    • If 4 VMs are created and 1 instance fails, the failed VM is deleted. The cluster is resized to 4 instances and placed in a RUNNING state.
    • If 2 instances are created and 3 instances fail, the cluster in placed in an ERROR state. The failed VMs are not deleted.

#min_num_instances=

def min_num_instances=(value) -> ::Integer
Parameter
  • value (::Integer) —

    Optional. The minimum number of primary worker instances to create. If min_num_instances is set, cluster creation will succeed if the number of primary workers created is at least equal to the min_num_instances number.

    Example: Cluster creation request with num_instances = 5 and min_num_instances = 3:

    • If 4 VMs are created and 1 instance fails, the failed VM is deleted. The cluster is resized to 4 instances and placed in a RUNNING state.
    • If 2 instances are created and 3 instances fail, the cluster in placed in an ERROR state. The failed VMs are not deleted.
Returns
  • (::Integer) —

    Optional. The minimum number of primary worker instances to create. If min_num_instances is set, cluster creation will succeed if the number of primary workers created is at least equal to the min_num_instances number.

    Example: Cluster creation request with num_instances = 5 and min_num_instances = 3:

    • If 4 VMs are created and 1 instance fails, the failed VM is deleted. The cluster is resized to 4 instances and placed in a RUNNING state.
    • If 2 instances are created and 3 instances fail, the cluster in placed in an ERROR state. The failed VMs are not deleted.

#num_instances

def num_instances() -> ::Integer
Returns
  • (::Integer) — Optional. The number of VM instances in the instance group. For HA cluster master_config groups, must be set to 3. For standard cluster master_config groups, must be set to 1.

#num_instances=

def num_instances=(value) -> ::Integer
Parameter
  • value (::Integer) — Optional. The number of VM instances in the instance group. For HA cluster master_config groups, must be set to 3. For standard cluster master_config groups, must be set to 1.
Returns
  • (::Integer) — Optional. The number of VM instances in the instance group. For HA cluster master_config groups, must be set to 3. For standard cluster master_config groups, must be set to 1.

#preemptibility

def preemptibility() -> ::Google::Cloud::Dataproc::V1::InstanceGroupConfig::Preemptibility
Returns

#preemptibility=

def preemptibility=(value) -> ::Google::Cloud::Dataproc::V1::InstanceGroupConfig::Preemptibility
Parameter
Returns

#startup_config

def startup_config() -> ::Google::Cloud::Dataproc::V1::StartupConfig
Returns

#startup_config=

def startup_config=(value) -> ::Google::Cloud::Dataproc::V1::StartupConfig
Parameter
Returns