Class InstanceGroupConfig (4.21.0)

public final class InstanceGroupConfig extends GeneratedMessageV3 implements InstanceGroupConfigOrBuilder

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

Protobuf type google.cloud.dataproc.v1.InstanceGroupConfig

Static Fields

ACCELERATORS_FIELD_NUMBER

public static final int ACCELERATORS_FIELD_NUMBER
Field Value
TypeDescription
int

DISK_CONFIG_FIELD_NUMBER

public static final int DISK_CONFIG_FIELD_NUMBER
Field Value
TypeDescription
int

IMAGE_URI_FIELD_NUMBER

public static final int IMAGE_URI_FIELD_NUMBER
Field Value
TypeDescription
int

INSTANCE_FLEXIBILITY_POLICY_FIELD_NUMBER

public static final int INSTANCE_FLEXIBILITY_POLICY_FIELD_NUMBER
Field Value
TypeDescription
int

INSTANCE_NAMES_FIELD_NUMBER

public static final int INSTANCE_NAMES_FIELD_NUMBER
Field Value
TypeDescription
int

INSTANCE_REFERENCES_FIELD_NUMBER

public static final int INSTANCE_REFERENCES_FIELD_NUMBER
Field Value
TypeDescription
int

IS_PREEMPTIBLE_FIELD_NUMBER

public static final int IS_PREEMPTIBLE_FIELD_NUMBER
Field Value
TypeDescription
int

MACHINE_TYPE_URI_FIELD_NUMBER

public static final int MACHINE_TYPE_URI_FIELD_NUMBER
Field Value
TypeDescription
int

MANAGED_GROUP_CONFIG_FIELD_NUMBER

public static final int MANAGED_GROUP_CONFIG_FIELD_NUMBER
Field Value
TypeDescription
int

MIN_CPU_PLATFORM_FIELD_NUMBER

public static final int MIN_CPU_PLATFORM_FIELD_NUMBER
Field Value
TypeDescription
int

MIN_NUM_INSTANCES_FIELD_NUMBER

public static final int MIN_NUM_INSTANCES_FIELD_NUMBER
Field Value
TypeDescription
int

NUM_INSTANCES_FIELD_NUMBER

public static final int NUM_INSTANCES_FIELD_NUMBER
Field Value
TypeDescription
int

PREEMPTIBILITY_FIELD_NUMBER

public static final int PREEMPTIBILITY_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static InstanceGroupConfig getDefaultInstance()
Returns
TypeDescription
InstanceGroupConfig

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static InstanceGroupConfig.Builder newBuilder()
Returns
TypeDescription
InstanceGroupConfig.Builder

newBuilder(InstanceGroupConfig prototype)

public static InstanceGroupConfig.Builder newBuilder(InstanceGroupConfig prototype)
Parameter
NameDescription
prototypeInstanceGroupConfig
Returns
TypeDescription
InstanceGroupConfig.Builder

parseDelimitedFrom(InputStream input)

public static InstanceGroupConfig parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static InstanceGroupConfig parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static InstanceGroupConfig parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static InstanceGroupConfig parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static InstanceGroupConfig parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static InstanceGroupConfig parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static InstanceGroupConfig parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
InstanceGroupConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<InstanceGroupConfig> parser()
Returns
TypeDescription
Parser<InstanceGroupConfig>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getAccelerators(int index)

public AcceleratorConfig getAccelerators(int index)

Optional. The Compute Engine accelerator configuration for these instances.

repeated .google.cloud.dataproc.v1.AcceleratorConfig accelerators = 8 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
indexint
Returns
TypeDescription
AcceleratorConfig

getAcceleratorsCount()

public int getAcceleratorsCount()

Optional. The Compute Engine accelerator configuration for these instances.

repeated .google.cloud.dataproc.v1.AcceleratorConfig accelerators = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
int

getAcceleratorsList()

public List<AcceleratorConfig> getAcceleratorsList()

Optional. The Compute Engine accelerator configuration for these instances.

repeated .google.cloud.dataproc.v1.AcceleratorConfig accelerators = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
List<AcceleratorConfig>

getAcceleratorsOrBuilder(int index)

public AcceleratorConfigOrBuilder getAcceleratorsOrBuilder(int index)

Optional. The Compute Engine accelerator configuration for these instances.

repeated .google.cloud.dataproc.v1.AcceleratorConfig accelerators = 8 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
indexint
Returns
TypeDescription
AcceleratorConfigOrBuilder

getAcceleratorsOrBuilderList()

public List<? extends AcceleratorConfigOrBuilder> getAcceleratorsOrBuilderList()

Optional. The Compute Engine accelerator configuration for these instances.

repeated .google.cloud.dataproc.v1.AcceleratorConfig accelerators = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
List<? extends com.google.cloud.dataproc.v1.AcceleratorConfigOrBuilder>

getDefaultInstanceForType()

public InstanceGroupConfig getDefaultInstanceForType()
Returns
TypeDescription
InstanceGroupConfig

getDiskConfig()

public DiskConfig getDiskConfig()

Optional. Disk option config settings.

.google.cloud.dataproc.v1.DiskConfig disk_config = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
DiskConfig

The diskConfig.

getDiskConfigOrBuilder()

public DiskConfigOrBuilder getDiskConfigOrBuilder()

Optional. Disk option config settings.

.google.cloud.dataproc.v1.DiskConfig disk_config = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
DiskConfigOrBuilder

getImageUri()

public String 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/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.

string image_uri = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
String

The imageUri.

getImageUriBytes()

public ByteString getImageUriBytes()

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.

string image_uri = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
ByteString

The bytes for imageUri.

getInstanceFlexibilityPolicy()

public InstanceFlexibilityPolicy getInstanceFlexibilityPolicy()

Optional. Instance flexibility Policy allowing a mixture of VM shapes and provisioning models.

.google.cloud.dataproc.v1.InstanceFlexibilityPolicy instance_flexibility_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
InstanceFlexibilityPolicy

The instanceFlexibilityPolicy.

getInstanceFlexibilityPolicyOrBuilder()

public InstanceFlexibilityPolicyOrBuilder getInstanceFlexibilityPolicyOrBuilder()

Optional. Instance flexibility Policy allowing a mixture of VM shapes and provisioning models.

.google.cloud.dataproc.v1.InstanceFlexibilityPolicy instance_flexibility_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
InstanceFlexibilityPolicyOrBuilder

getInstanceNames(int index)

public String getInstanceNames(int index)

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

repeated string instance_names = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The instanceNames at the given index.

getInstanceNamesBytes(int index)

public ByteString getInstanceNamesBytes(int index)

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

repeated string instance_names = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the instanceNames at the given index.

getInstanceNamesCount()

public int getInstanceNamesCount()

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

repeated string instance_names = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The count of instanceNames.

getInstanceNamesList()

public ProtocolStringList getInstanceNamesList()

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

repeated string instance_names = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ProtocolStringList

A list containing the instanceNames.

getInstanceReferences(int index)

public InstanceReference getInstanceReferences(int index)

Output only. List of references to Compute Engine instances.

repeated .google.cloud.dataproc.v1.InstanceReference instance_references = 11 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint
Returns
TypeDescription
InstanceReference

getInstanceReferencesCount()

public int getInstanceReferencesCount()

Output only. List of references to Compute Engine instances.

repeated .google.cloud.dataproc.v1.InstanceReference instance_references = 11 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

getInstanceReferencesList()

public List<InstanceReference> getInstanceReferencesList()

Output only. List of references to Compute Engine instances.

repeated .google.cloud.dataproc.v1.InstanceReference instance_references = 11 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<InstanceReference>

getInstanceReferencesOrBuilder(int index)

public InstanceReferenceOrBuilder getInstanceReferencesOrBuilder(int index)

Output only. List of references to Compute Engine instances.

repeated .google.cloud.dataproc.v1.InstanceReference instance_references = 11 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint
Returns
TypeDescription
InstanceReferenceOrBuilder

getInstanceReferencesOrBuilderList()

public List<? extends InstanceReferenceOrBuilder> getInstanceReferencesOrBuilderList()

Output only. List of references to Compute Engine instances.

repeated .google.cloud.dataproc.v1.InstanceReference instance_references = 11 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<? extends com.google.cloud.dataproc.v1.InstanceReferenceOrBuilder>

getIsPreemptible()

public boolean getIsPreemptible()

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

bool is_preemptible = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

The isPreemptible.

getMachineTypeUri()

public String 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/[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.

string machine_type_uri = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
String

The machineTypeUri.

getMachineTypeUriBytes()

public ByteString getMachineTypeUriBytes()

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.

string machine_type_uri = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
ByteString

The bytes for machineTypeUri.

getManagedGroupConfig()

public ManagedGroupConfig getManagedGroupConfig()

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

.google.cloud.dataproc.v1.ManagedGroupConfig managed_group_config = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ManagedGroupConfig

The managedGroupConfig.

getManagedGroupConfigOrBuilder()

public ManagedGroupConfigOrBuilder getManagedGroupConfigOrBuilder()

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

.google.cloud.dataproc.v1.ManagedGroupConfig managed_group_config = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ManagedGroupConfigOrBuilder

getMinCpuPlatform()

public String getMinCpuPlatform()

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

string min_cpu_platform = 9 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
String

The minCpuPlatform.

getMinCpuPlatformBytes()

public ByteString getMinCpuPlatformBytes()

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

string min_cpu_platform = 9 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
ByteString

The bytes for minCpuPlatform.

getMinNumInstances()

public int getMinNumInstances()

Optional. The minimum number of instances to create. If min_num_instances is set, min_num_instances is used for a criteria to decide the cluster. Cluster creation will be failed by being an error state if the total number of instances created is less than the min_num_instances. For example, given that num_instances = 5 and min_num_instances = 3,

  • if 4 instances are created and then registered successfully but one instance is failed, the failed VM will be deleted and the cluster will be resized to 4 instances in running state.
  • if 2 instances are created successfully and 3 instances are failed, the cluster will be in an error state and does not delete failed VMs for debugging.
  • if 2 instance are created and then registered successfully but 3 instances are failed to initialize, the cluster will be in an error state and does not delete failed VMs for debugging. NB: This can only be set for primary workers now.

int32 min_num_instances = 12 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
int

The minNumInstances.

getNumInstances()

public int 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.

int32 num_instances = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
int

The numInstances.

getParserForType()

public Parser<InstanceGroupConfig> getParserForType()
Returns
TypeDescription
Parser<InstanceGroupConfig>
Overrides

getPreemptibility()

public InstanceGroupConfig.Preemptibility 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.

.google.cloud.dataproc.v1.InstanceGroupConfig.Preemptibility preemptibility = 10 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
InstanceGroupConfig.Preemptibility

The preemptibility.

getPreemptibilityValue()

public int getPreemptibilityValue()

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.

.google.cloud.dataproc.v1.InstanceGroupConfig.Preemptibility preemptibility = 10 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
int

The enum numeric value on the wire for preemptibility.

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

hasDiskConfig()

public boolean hasDiskConfig()

Optional. Disk option config settings.

.google.cloud.dataproc.v1.DiskConfig disk_config = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
boolean

Whether the diskConfig field is set.

hasInstanceFlexibilityPolicy()

public boolean hasInstanceFlexibilityPolicy()

Optional. Instance flexibility Policy allowing a mixture of VM shapes and provisioning models.

.google.cloud.dataproc.v1.InstanceFlexibilityPolicy instance_flexibility_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
boolean

Whether the instanceFlexibilityPolicy field is set.

hasManagedGroupConfig()

public boolean hasManagedGroupConfig()

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

.google.cloud.dataproc.v1.ManagedGroupConfig managed_group_config = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the managedGroupConfig field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public InstanceGroupConfig.Builder newBuilderForType()
Returns
TypeDescription
InstanceGroupConfig.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected InstanceGroupConfig.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
InstanceGroupConfig.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public InstanceGroupConfig.Builder toBuilder()
Returns
TypeDescription
InstanceGroupConfig.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException