Google Cloud Dataproc V1 Client - Class InstanceGroupConfig (3.3.0)

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

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

Generated from protobuf message google.cloud.dataproc.v1.InstanceGroupConfig

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ num_instances int

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.

↳ instance_names array

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

↳ image_uri 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.

↳ machine_type_uri 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.

↳ disk_config Google\Cloud\Dataproc\V1\DiskConfig

Optional. Disk option config settings.

↳ is_preemptible bool

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

↳ preemptibility int

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.

↳ managed_group_config Google\Cloud\Dataproc\V1\ManagedGroupConfig

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

↳ accelerators array<Google\Cloud\Dataproc\V1\AcceleratorConfig>

Optional. The Compute Engine accelerator configuration for these instances.

↳ min_cpu_platform string

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

getNumInstances

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
TypeDescription
int

setNumInstances

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.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getInstanceNames

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

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setInstanceNames

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

Parameter
NameDescription
var string[]
Returns
TypeDescription
$this

getImageUri

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
TypeDescription
string

setImageUri

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.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getMachineTypeUri

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
TypeDescription
string

setMachineTypeUri

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.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDiskConfig

Optional. Disk option config settings.

Returns
TypeDescription
Google\Cloud\Dataproc\V1\DiskConfig|null

hasDiskConfig

clearDiskConfig

setDiskConfig

Optional. Disk option config settings.

Parameter
NameDescription
var Google\Cloud\Dataproc\V1\DiskConfig
Returns
TypeDescription
$this

getIsPreemptible

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

Returns
TypeDescription
bool

setIsPreemptible

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

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getPreemptibility

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
TypeDescription
int

setPreemptibility

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.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getManagedGroupConfig

Output only. The config for Compute Engine Instance Group Manager that manages this group.

This is only used for preemptible instance groups.

Returns
TypeDescription
Google\Cloud\Dataproc\V1\ManagedGroupConfig|null

hasManagedGroupConfig

clearManagedGroupConfig

setManagedGroupConfig

Output only. The config for Compute Engine Instance Group Manager that manages this group.

This is only used for preemptible instance groups.

Parameter
NameDescription
var Google\Cloud\Dataproc\V1\ManagedGroupConfig
Returns
TypeDescription
$this

getAccelerators

Optional. The Compute Engine accelerator configuration for these instances.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setAccelerators

Optional. The Compute Engine accelerator configuration for these instances.

Parameter
NameDescription
var array<Google\Cloud\Dataproc\V1\AcceleratorConfig>
Returns
TypeDescription
$this

getMinCpuPlatform

Optional. Specifies the minimum cpu platform for the Instance Group.

See Dataproc -> Minimum CPU Platform.

Returns
TypeDescription
string

setMinCpuPlatform

Optional. Specifies the minimum cpu platform for the Instance Group.

See Dataproc -> Minimum CPU Platform.

Parameter
NameDescription
var string
Returns
TypeDescription
$this