pulumi-gcp 7.19.0a1713335069__py3-none-any.whl → 7.20.0__py3-none-any.whl

pulumi_gcp/dataproc/outputs.py

@@ -1023,10 +1023,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroup(dict):
         """
         :param Sequence[str] roles: Node group roles. 
                One of `"DRIVER"`.
-        :param str name: The name of the cluster, unique within the project and
-               zone.
-               
-               - - -
+        :param str name: The Node group resource name.
         :param 'ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigArgs' node_group_config: The node group instance group configuration.
         """
         pulumi.set(__self__, "roles", roles)
@@ -1048,10 +1045,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroup(dict):
     @pulumi.getter
     def name(self) -> Optional[str]:
         """
-        The name of the cluster, unique within the project and
-        zone.
-
-        - - -
+        The Node group resource name.
         """
         return pulumi.get(self, "name")
 
@@ -1099,19 +1093,12 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfig(dict):
                  min_cpu_platform: Optional[str] = None,
                  num_instances: Optional[int] = None):
         """
-        :param Sequence['ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAcceleratorArgs'] accelerators: The Compute Engine accelerator (GPU) configuration for these instances. Can be specified 
-               multiple times.
+        :param Sequence['ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAcceleratorArgs'] accelerators: The Compute Engine accelerator (GPU) configuration for these instances. Can be specified multiple times.
         :param 'ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigDiskConfigArgs' disk_config: Disk Config
         :param Sequence[str] instance_names: List of auxiliary node group instance names which have been assigned to the cluster.
-        :param str machine_type: The name of a Google Compute Engine machine type
-               to create for the node group. If not specified, GCP will default to a predetermined
-               computed value (currently `n1-standard-4`).
-        :param str min_cpu_platform: The name of a minimum generation of CPU family
-               for the node group. If not specified, GCP will default to a predetermined computed value
-               for each zone. See [the guide](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
-               for details about which CPU families are available (and defaulted) for each zone.
-        :param int num_instances: Specifies the number of master nodes to create.
-               Please set a number greater than 0. Node Group must have at least 1 instance.
+        :param str machine_type: The name of a Google Compute Engine machine type to create for the master
+        :param str min_cpu_platform: The name of a minimum generation of CPU family for the auxiliary node group. If not specified, GCP will default to a predetermined computed value for each zone.
+        :param int num_instances: Specifies the number of auxiliary nodes to create. If not specified, GCP will default to a predetermined computed value.
         """
         if accelerators is not None:
             pulumi.set(__self__, "accelerators", accelerators)
@@ -1130,8 +1117,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfig(dict):
     @pulumi.getter
     def accelerators(self) -> Optional[Sequence['outputs.ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAccelerator']]:
         """
-        The Compute Engine accelerator (GPU) configuration for these instances. Can be specified 
-        multiple times.
+        The Compute Engine accelerator (GPU) configuration for these instances. Can be specified multiple times.
         """
         return pulumi.get(self, "accelerators")
 
@@ -1155,9 +1141,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfig(dict):
     @pulumi.getter(name="machineType")
     def machine_type(self) -> Optional[str]:
         """
-        The name of a Google Compute Engine machine type
-        to create for the node group. If not specified, GCP will default to a predetermined
-        computed value (currently `n1-standard-4`).
+        The name of a Google Compute Engine machine type to create for the master
         """
         return pulumi.get(self, "machine_type")
 
@@ -1165,10 +1149,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfig(dict):
     @pulumi.getter(name="minCpuPlatform")
     def min_cpu_platform(self) -> Optional[str]:
         """
-        The name of a minimum generation of CPU family
-        for the node group. If not specified, GCP will default to a predetermined computed value
-        for each zone. See [the guide](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
-        for details about which CPU families are available (and defaulted) for each zone.
+        The name of a minimum generation of CPU family for the auxiliary node group. If not specified, GCP will default to a predetermined computed value for each zone.
         """
         return pulumi.get(self, "min_cpu_platform")
 
@@ -1176,8 +1157,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfig(dict):
     @pulumi.getter(name="numInstances")
     def num_instances(self) -> Optional[int]:
         """
-        Specifies the number of master nodes to create.
-        Please set a number greater than 0. Node Group must have at least 1 instance.
+        Specifies the number of auxiliary nodes to create. If not specified, GCP will default to a predetermined computed value.
         """
         return pulumi.get(self, "num_instances")
 
@@ -1207,11 +1187,8 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAccelerator(
                  accelerator_count: int,
                  accelerator_type: str):
         """
-        :param int accelerator_count: The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
-               
-               
-               - - -
-        :param str accelerator_type: The short name of the accelerator type to expose to this instance. For example, `nvidia-tesla-k80`.
+        :param int accelerator_count: The number of the accelerator cards of this type exposed to this instance. Often restricted to one of 1, 2, 4, or 8.
+        :param str accelerator_type: The short name of the accelerator type to expose to this instance. For example, nvidia-tesla-k80.
         """
         pulumi.set(__self__, "accelerator_count", accelerator_count)
         pulumi.set(__self__, "accelerator_type", accelerator_type)
@@ -1220,10 +1197,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAccelerator(
     @pulumi.getter(name="acceleratorCount")
     def accelerator_count(self) -> int:
         """
-        The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
-
-
-        - - -
+        The number of the accelerator cards of this type exposed to this instance. Often restricted to one of 1, 2, 4, or 8.
         """
         return pulumi.get(self, "accelerator_count")
 
@@ -1231,7 +1205,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigAccelerator(
     @pulumi.getter(name="acceleratorType")
     def accelerator_type(self) -> str:
         """
-        The short name of the accelerator type to expose to this instance. For example, `nvidia-tesla-k80`.
+        The short name of the accelerator type to expose to this instance. For example, nvidia-tesla-k80.
         """
         return pulumi.get(self, "accelerator_type")
 
@@ -1264,15 +1238,9 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigDiskConfig(d
                  boot_disk_type: Optional[str] = None,
                  num_local_ssds: Optional[int] = None):
         """
-        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified
-               in GB. The primary disk contains the boot volume and system libraries, and the
-               smallest allowed disk size is 10GB. GCP will default to a predetermined
-               computed value if not set (currently 500GB). Note: If SSDs are not
-               attached, it also contains the HDFS data blocks and Hadoop working directories.
-        :param str boot_disk_type: The disk type of the primary disk attached to each node.
-               One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
-        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. 
-               Defaults to 0.
+        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified in GB. The primary disk contains the boot volume and system libraries, and the smallest allowed disk size is 10GB. GCP will default to a predetermined computed value if not set (currently 500GB). Note: If SSDs are not attached, it also contains the HDFS data blocks and Hadoop working directories.
+        :param str boot_disk_type: The disk type of the primary disk attached to each node. Such as "pd-ssd" or "pd-standard". Defaults to "pd-standard".
+        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. Defaults to 0.
         """
         if boot_disk_size_gb is not None:
             pulumi.set(__self__, "boot_disk_size_gb", boot_disk_size_gb)
@@ -1285,11 +1253,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigDiskConfig(d
     @pulumi.getter(name="bootDiskSizeGb")
     def boot_disk_size_gb(self) -> Optional[int]:
         """
-        Size of the primary disk attached to each node, specified
-        in GB. The primary disk contains the boot volume and system libraries, and the
-        smallest allowed disk size is 10GB. GCP will default to a predetermined
-        computed value if not set (currently 500GB). Note: If SSDs are not
-        attached, it also contains the HDFS data blocks and Hadoop working directories.
+        Size of the primary disk attached to each node, specified in GB. The primary disk contains the boot volume and system libraries, and the smallest allowed disk size is 10GB. GCP will default to a predetermined computed value if not set (currently 500GB). Note: If SSDs are not attached, it also contains the HDFS data blocks and Hadoop working directories.
         """
         return pulumi.get(self, "boot_disk_size_gb")
 
@@ -1297,8 +1261,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigDiskConfig(d
     @pulumi.getter(name="bootDiskType")
     def boot_disk_type(self) -> Optional[str]:
         """
-        The disk type of the primary disk attached to each node.
-        One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
+        The disk type of the primary disk attached to each node. Such as "pd-ssd" or "pd-standard". Defaults to "pd-standard".
         """
         return pulumi.get(self, "boot_disk_type")
 
@@ -1306,8 +1269,7 @@ class ClusterClusterConfigAuxiliaryNodeGroupNodeGroupNodeGroupConfigDiskConfig(d
     @pulumi.getter(name="numLocalSsds")
     def num_local_ssds(self) -> Optional[int]:
         """
-        The amount of local SSD disks that will be attached to each master cluster node. 
-        Defaults to 0.
+        The amount of local SSD disks that will be attached to each master cluster node. Defaults to 0.
         """
         return pulumi.get(self, "num_local_ssds")
 
@@ -1451,7 +1413,8 @@ class ClusterClusterConfigEndpointConfig(dict):
         """
         :param bool enable_http_port_access: The flag to enable http access to specific ports
                on the cluster from external sources (aka Component Gateway). Defaults to false.
-        :param Mapping[str, Any] http_ports: The map of port descriptions to URLs. Will only be populated if enable_http_port_access is true.
+        :param Mapping[str, Any] http_ports: The map of port descriptions to URLs. Will only be populated if
+               `enable_http_port_access` is true.
         """
         pulumi.set(__self__, "enable_http_port_access", enable_http_port_access)
         if http_ports is not None:
@@ -1470,7 +1433,8 @@ class ClusterClusterConfigEndpointConfig(dict):
     @pulumi.getter(name="httpPorts")
     def http_ports(self) -> Optional[Mapping[str, Any]]:
         """
-        The map of port descriptions to URLs. Will only be populated if enable_http_port_access is true.
+        The map of port descriptions to URLs. Will only be populated if
+        `enable_http_port_access` is true.
         """
         return pulumi.get(self, "http_ports")
 
@@ -1940,7 +1904,8 @@ class ClusterClusterConfigLifecycleConfig(dict):
                - - -
         :param str idle_delete_ttl: The duration to keep the cluster alive while idling
                (no jobs running). After this TTL, the cluster will be deleted. Valid range: [10m, 14d].
-        :param str idle_start_time: Time when the cluster became idle (most recent job finished) and became eligible for deletion due to idleness.
+        :param str idle_start_time: Time when the cluster became idle
+               (most recent job finished) and became eligible for deletion due to idleness.
         """
         if auto_delete_time is not None:
             pulumi.set(__self__, "auto_delete_time", auto_delete_time)
@@ -1974,7 +1939,8 @@ class ClusterClusterConfigLifecycleConfig(dict):
     @pulumi.getter(name="idleStartTime")
     def idle_start_time(self) -> Optional[str]:
         """
-        Time when the cluster became idle (most recent job finished) and became eligible for deletion due to idleness.
+        Time when the cluster became idle
+        (most recent job finished) and became eligible for deletion due to idleness.
         """
         return pulumi.get(self, "idle_start_time")
 
@@ -2021,7 +1987,8 @@ class ClusterClusterConfigMasterConfig(dict):
         :param 'ClusterClusterConfigMasterConfigDiskConfigArgs' disk_config: Disk Config
         :param str image_uri: The URI for the image to use for this worker.  See [the guide](https://cloud.google.com/dataproc/docs/guides/dataproc-images)
                for more information.
-        :param Sequence[str] instance_names: List of master instance names which have been assigned to the cluster.
+        :param Sequence[str] instance_names: List of master instance names which
+               have been assigned to the cluster.
         :param str machine_type: The name of a Google Compute Engine machine type
                to create for the master. If not specified, GCP will default to a predetermined
                computed value (currently `n1-standard-4`).
@@ -2076,7 +2043,8 @@ class ClusterClusterConfigMasterConfig(dict):
     @pulumi.getter(name="instanceNames")
     def instance_names(self) -> Optional[Sequence[str]]:
         """
-        List of master instance names which have been assigned to the cluster.
+        List of master instance names which
+        have been assigned to the cluster.
         """
         return pulumi.get(self, "instance_names")
 
@@ -2138,6 +2106,9 @@ class ClusterClusterConfigMasterConfigAccelerator(dict):
         """
         :param int accelerator_count: The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
                
+               > The Cloud Dataproc API can return unintuitive error messages when using accelerators; even when you have defined an accelerator, Auto Zone Placement does not exclusively select
+               zones that have that accelerator available. If you get a 400 error that the accelerator can't be found, this is a likely cause. Make sure you check [accelerator availability by zone](https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/list)
+               if you are trying to use accelerators in a given zone.
                
                - - -
         :param str accelerator_type: The short name of the accelerator type to expose to this instance. For example, `nvidia-tesla-k80`.
@@ -2151,6 +2122,9 @@ class ClusterClusterConfigMasterConfigAccelerator(dict):
         """
         The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
 
+        > The Cloud Dataproc API can return unintuitive error messages when using accelerators; even when you have defined an accelerator, Auto Zone Placement does not exclusively select
+        zones that have that accelerator available. If you get a 400 error that the accelerator can't be found, this is a likely cause. Make sure you check [accelerator availability by zone](https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/list)
+        if you are trying to use accelerators in a given zone.
 
         - - -
         """
@@ -2193,15 +2167,9 @@ class ClusterClusterConfigMasterConfigDiskConfig(dict):
                  boot_disk_type: Optional[str] = None,
                  num_local_ssds: Optional[int] = None):
         """
-        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified
-               in GB. The primary disk contains the boot volume and system libraries, and the
-               smallest allowed disk size is 10GB. GCP will default to a predetermined
-               computed value if not set (currently 500GB). Note: If SSDs are not
-               attached, it also contains the HDFS data blocks and Hadoop working directories.
-        :param str boot_disk_type: The disk type of the primary disk attached to each node.
-               One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
-        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. 
-               Defaults to 0.
+        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified in GB. The primary disk contains the boot volume and system libraries, and the smallest allowed disk size is 10GB. GCP will default to a predetermined computed value if not set (currently 500GB). Note: If SSDs are not attached, it also contains the HDFS data blocks and Hadoop working directories.
+        :param str boot_disk_type: The disk type of the primary disk attached to each node. Such as "pd-ssd" or "pd-standard". Defaults to "pd-standard".
+        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. Defaults to 0.
         """
         if boot_disk_size_gb is not None:
             pulumi.set(__self__, "boot_disk_size_gb", boot_disk_size_gb)
@@ -2214,11 +2182,7 @@ class ClusterClusterConfigMasterConfigDiskConfig(dict):
     @pulumi.getter(name="bootDiskSizeGb")
     def boot_disk_size_gb(self) -> Optional[int]:
         """
-        Size of the primary disk attached to each node, specified
-        in GB. The primary disk contains the boot volume and system libraries, and the
-        smallest allowed disk size is 10GB. GCP will default to a predetermined
-        computed value if not set (currently 500GB). Note: If SSDs are not
-        attached, it also contains the HDFS data blocks and Hadoop working directories.
+        Size of the primary disk attached to each node, specified in GB. The primary disk contains the boot volume and system libraries, and the smallest allowed disk size is 10GB. GCP will default to a predetermined computed value if not set (currently 500GB). Note: If SSDs are not attached, it also contains the HDFS data blocks and Hadoop working directories.
         """
         return pulumi.get(self, "boot_disk_size_gb")
 
@@ -2226,8 +2190,7 @@ class ClusterClusterConfigMasterConfigDiskConfig(dict):
     @pulumi.getter(name="bootDiskType")
     def boot_disk_type(self) -> Optional[str]:
         """
-        The disk type of the primary disk attached to each node.
-        One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
+        The disk type of the primary disk attached to each node. Such as "pd-ssd" or "pd-standard". Defaults to "pd-standard".
         """
         return pulumi.get(self, "boot_disk_type")
 
@@ -2235,8 +2198,7 @@ class ClusterClusterConfigMasterConfigDiskConfig(dict):
     @pulumi.getter(name="numLocalSsds")
     def num_local_ssds(self) -> Optional[int]:
         """
-        The amount of local SSD disks that will be attached to each master cluster node. 
-        Defaults to 0.
+        The amount of local SSD disks that will be attached to each master cluster node. Defaults to 0.
         """
         return pulumi.get(self, "num_local_ssds")
 
@@ -2318,7 +2280,8 @@ class ClusterClusterConfigPreemptibleWorkerConfig(dict):
         """
         :param 'ClusterClusterConfigPreemptibleWorkerConfigDiskConfigArgs' disk_config: Disk Config
         :param 'ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyArgs' instance_flexibility_policy: Instance flexibility Policy allowing a mixture of VM shapes and provisioning models.
-        :param Sequence[str] instance_names: List of preemptible instance names which have been assigned to the cluster.
+        :param Sequence[str] instance_names: List of preemptible instance names which have been assigned
+               to the cluster.
         :param int num_instances: Specifies the number of preemptible nodes to create.
                Defaults to 0.
         :param str preemptibility: Specifies the preemptibility of the secondary workers. The default value is `PREEMPTIBLE`
@@ -2358,7 +2321,8 @@ class ClusterClusterConfigPreemptibleWorkerConfig(dict):
     @pulumi.getter(name="instanceNames")
     def instance_names(self) -> Optional[Sequence[str]]:
         """
-        List of preemptible instance names which have been assigned to the cluster.
+        List of preemptible instance names which have been assigned
+        to the cluster.
         """
         return pulumi.get(self, "instance_names")
 
@@ -2412,15 +2376,13 @@ class ClusterClusterConfigPreemptibleWorkerConfigDiskConfig(dict):
                  boot_disk_type: Optional[str] = None,
                  num_local_ssds: Optional[int] = None):
         """
-        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified
-               in GB. The primary disk contains the boot volume and system libraries, and the
-               smallest allowed disk size is 10GB. GCP will default to a predetermined
+        :param int boot_disk_size_gb: Size of the primary disk attached to each preemptible worker node, specified
+               in GB. The smallest allowed disk size is 10GB. GCP will default to a predetermined
                computed value if not set (currently 500GB). Note: If SSDs are not
                attached, it also contains the HDFS data blocks and Hadoop working directories.
-        :param str boot_disk_type: The disk type of the primary disk attached to each node.
+        :param str boot_disk_type: The disk type of the primary disk attached to each preemptible worker node.
                One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
-        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. 
-               Defaults to 0.
+        :param int num_local_ssds: The amount of local SSD disks that will be attached to each preemptible worker node. Defaults to 0.
         """
         if boot_disk_size_gb is not None:
             pulumi.set(__self__, "boot_disk_size_gb", boot_disk_size_gb)
@@ -2433,9 +2395,8 @@ class ClusterClusterConfigPreemptibleWorkerConfigDiskConfig(dict):
     @pulumi.getter(name="bootDiskSizeGb")
     def boot_disk_size_gb(self) -> Optional[int]:
         """
-        Size of the primary disk attached to each node, specified
-        in GB. The primary disk contains the boot volume and system libraries, and the
-        smallest allowed disk size is 10GB. GCP will default to a predetermined
+        Size of the primary disk attached to each preemptible worker node, specified
+        in GB. The smallest allowed disk size is 10GB. GCP will default to a predetermined
         computed value if not set (currently 500GB). Note: If SSDs are not
         attached, it also contains the HDFS data blocks and Hadoop working directories.
         """
@@ -2445,7 +2406,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigDiskConfig(dict):
     @pulumi.getter(name="bootDiskType")
     def boot_disk_type(self) -> Optional[str]:
         """
-        The disk type of the primary disk attached to each node.
+        The disk type of the primary disk attached to each preemptible worker node.
         One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
         """
         return pulumi.get(self, "boot_disk_type")
@@ -2454,8 +2415,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigDiskConfig(dict):
     @pulumi.getter(name="numLocalSsds")
     def num_local_ssds(self) -> Optional[int]:
         """
-        The amount of local SSD disks that will be attached to each master cluster node. 
-        Defaults to 0.
+        The amount of local SSD disks that will be attached to each preemptible worker node. Defaults to 0.
         """
         return pulumi.get(self, "num_local_ssds")
 
@@ -2533,10 +2493,8 @@ class ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyInstan
                  machine_types: Optional[Sequence[str]] = None,
                  rank: Optional[int] = None):
         """
-        :param Sequence[str] machine_types: Full machine-type names, e.g. `"n1-standard-16"`.
-        :param int rank: Preference of this instance selection. A lower number means higher preference. Dataproc will first try to create a VM based on the machine-type with priority rank and fallback to next rank based on availability. Machine types and instance selections with the same priority have the same preference.
-               
-               - - -
+        :param Sequence[str] machine_types: Full machine-type names, e.g. "n1-standard-16".
+        :param int rank: Preference of this instance selection. Lower number means higher preference. Dataproc will first try to create a VM based on the machine-type with priority rank and fallback to next rank based on availability. Machine types and instance selections with the same priority have the same preference.
         """
         if machine_types is not None:
             pulumi.set(__self__, "machine_types", machine_types)
@@ -2547,7 +2505,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyInstan
     @pulumi.getter(name="machineTypes")
     def machine_types(self) -> Optional[Sequence[str]]:
         """
-        Full machine-type names, e.g. `"n1-standard-16"`.
+        Full machine-type names, e.g. "n1-standard-16".
         """
         return pulumi.get(self, "machine_types")
 
@@ -2555,9 +2513,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyInstan
     @pulumi.getter
     def rank(self) -> Optional[int]:
         """
-        Preference of this instance selection. A lower number means higher preference. Dataproc will first try to create a VM based on the machine-type with priority rank and fallback to next rank based on availability. Machine types and instance selections with the same priority have the same preference.
-
-        - - -
+        Preference of this instance selection. Lower number means higher preference. Dataproc will first try to create a VM based on the machine-type with priority rank and fallback to next rank based on availability. Machine types and instance selections with the same priority have the same preference.
         """
         return pulumi.get(self, "rank")
 
@@ -2587,9 +2543,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyInstan
                  machine_type: Optional[str] = None,
                  vm_count: Optional[int] = None):
         """
-        :param str machine_type: The name of a Google Compute Engine machine type
-               to create for the node group. If not specified, GCP will default to a predetermined
-               computed value (currently `n1-standard-4`).
+        :param str machine_type: Full machine-type names, e.g. "n1-standard-16".
         :param int vm_count: Number of VM provisioned with the machine_type.
         """
         if machine_type is not None:
@@ -2601,9 +2555,7 @@ class ClusterClusterConfigPreemptibleWorkerConfigInstanceFlexibilityPolicyInstan
     @pulumi.getter(name="machineType")
     def machine_type(self) -> Optional[str]:
         """
-        The name of a Google Compute Engine machine type
-        to create for the node group. If not specified, GCP will default to a predetermined
-        computed value (currently `n1-standard-4`).
+        Full machine-type names, e.g. "n1-standard-16".
         """
         return pulumi.get(self, "machine_type")
 
@@ -2956,8 +2908,8 @@ class ClusterClusterConfigSoftwareConfig(dict):
                used to modify various aspects of the common configuration files used when creating
                a cluster. For a list of valid properties please see
                [Cluster properties](https://cloud.google.com/dataproc/docs/concepts/cluster-properties)
-        :param Mapping[str, Any] properties: The properties to set on daemon config files. Property keys are specified in prefix:property format, 
-               for example spark:spark.kubernetes.container.image.
+        :param Mapping[str, Any] properties: A list of the properties used to set the daemon config files.
+               This will include any values supplied by the user via `cluster_config.software_config.override_properties`
         """
         if image_version is not None:
             pulumi.set(__self__, "image_version", image_version)
@@ -3005,8 +2957,8 @@ class ClusterClusterConfigSoftwareConfig(dict):
     @pulumi.getter
     def properties(self) -> Optional[Mapping[str, Any]]:
         """
-        The properties to set on daemon config files. Property keys are specified in prefix:property format, 
-        for example spark:spark.kubernetes.container.image.
+        A list of the properties used to set the daemon config files.
+        This will include any values supplied by the user via `cluster_config.software_config.override_properties`
         """
         return pulumi.get(self, "properties")
 
@@ -3056,7 +3008,8 @@ class ClusterClusterConfigWorkerConfig(dict):
         :param 'ClusterClusterConfigWorkerConfigDiskConfigArgs' disk_config: Disk Config
         :param str image_uri: The URI for the image to use for this worker.  See [the guide](https://cloud.google.com/dataproc/docs/guides/dataproc-images)
                for more information.
-        :param Sequence[str] instance_names: List of master/worker instance names which have been assigned to the cluster.
+        :param Sequence[str] instance_names: List of worker instance names which have been assigned
+               to the cluster.
         :param str machine_type: The name of a Google Compute Engine machine type
                to create for the worker nodes. If not specified, GCP will default to a predetermined
                computed value (currently `n1-standard-4`).
@@ -3119,7 +3072,8 @@ class ClusterClusterConfigWorkerConfig(dict):
     @pulumi.getter(name="instanceNames")
     def instance_names(self) -> Optional[Sequence[str]]:
         """
-        List of master/worker instance names which have been assigned to the cluster.
+        List of worker instance names which have been assigned
+        to the cluster.
         """
         return pulumi.get(self, "instance_names")
 
@@ -3194,6 +3148,9 @@ class ClusterClusterConfigWorkerConfigAccelerator(dict):
         """
         :param int accelerator_count: The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
                
+               > The Cloud Dataproc API can return unintuitive error messages when using accelerators; even when you have defined an accelerator, Auto Zone Placement does not exclusively select
+               zones that have that accelerator available. If you get a 400 error that the accelerator can't be found, this is a likely cause. Make sure you check [accelerator availability by zone](https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/list)
+               if you are trying to use accelerators in a given zone.
                
                - - -
         :param str accelerator_type: The short name of the accelerator type to expose to this instance. For example, `nvidia-tesla-k80`.
@@ -3207,6 +3164,9 @@ class ClusterClusterConfigWorkerConfigAccelerator(dict):
         """
         The number of the accelerator cards of this type exposed to this instance. Often restricted to one of `1`, `2`, `4`, or `8`.
 
+        > The Cloud Dataproc API can return unintuitive error messages when using accelerators; even when you have defined an accelerator, Auto Zone Placement does not exclusively select
+        zones that have that accelerator available. If you get a 400 error that the accelerator can't be found, this is a likely cause. Make sure you check [accelerator availability by zone](https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/list)
+        if you are trying to use accelerators in a given zone.
 
         - - -
         """
@@ -3249,15 +3209,14 @@ class ClusterClusterConfigWorkerConfigDiskConfig(dict):
                  boot_disk_type: Optional[str] = None,
                  num_local_ssds: Optional[int] = None):
         """
-        :param int boot_disk_size_gb: Size of the primary disk attached to each node, specified
-               in GB. The primary disk contains the boot volume and system libraries, and the
-               smallest allowed disk size is 10GB. GCP will default to a predetermined
+        :param int boot_disk_size_gb: Size of the primary disk attached to each worker node, specified
+               in GB. The smallest allowed disk size is 10GB. GCP will default to a predetermined
                computed value if not set (currently 500GB). Note: If SSDs are not
                attached, it also contains the HDFS data blocks and Hadoop working directories.
         :param str boot_disk_type: The disk type of the primary disk attached to each node.
                One of `"pd-ssd"` or `"pd-standard"`. Defaults to `"pd-standard"`.
-        :param int num_local_ssds: The amount of local SSD disks that will be attached to each master cluster node. 
-               Defaults to 0.
+        :param int num_local_ssds: The amount of local SSD disks that will be
+               attached to each worker cluster node. Defaults to 0.
         """
         if boot_disk_size_gb is not None:
             pulumi.set(__self__, "boot_disk_size_gb", boot_disk_size_gb)
@@ -3270,9 +3229,8 @@ class ClusterClusterConfigWorkerConfigDiskConfig(dict):
     @pulumi.getter(name="bootDiskSizeGb")
     def boot_disk_size_gb(self) -> Optional[int]:
         """
-        Size of the primary disk attached to each node, specified
-        in GB. The primary disk contains the boot volume and system libraries, and the
-        smallest allowed disk size is 10GB. GCP will default to a predetermined
+        Size of the primary disk attached to each worker node, specified
+        in GB. The smallest allowed disk size is 10GB. GCP will default to a predetermined
         computed value if not set (currently 500GB). Note: If SSDs are not
         attached, it also contains the HDFS data blocks and Hadoop working directories.
         """
@@ -3291,8 +3249,8 @@ class ClusterClusterConfigWorkerConfigDiskConfig(dict):
     @pulumi.getter(name="numLocalSsds")
     def num_local_ssds(self) -> Optional[int]:
         """
-        The amount of local SSD disks that will be attached to each master cluster node. 
-        Defaults to 0.
+        The amount of local SSD disks that will be
+        attached to each worker cluster node. Defaults to 0.
         """
         return pulumi.get(self, "num_local_ssds")
 
@@ -3506,10 +3464,6 @@ class ClusterVirtualClusterConfigAuxiliaryServicesConfigMetastoreConfig(dict):
                  dataproc_metastore_service: Optional[str] = None):
         """
         :param str dataproc_metastore_service: Resource name of an existing Dataproc Metastore service.
-               
-               Only resource names including projectid and location (region) are valid. Examples:
-               
-               `projects/[projectId]/locations/[dataproc_region]/services/[service-name]`
         """
         if dataproc_metastore_service is not None:
             pulumi.set(__self__, "dataproc_metastore_service", dataproc_metastore_service)
@@ -3519,10 +3473,6 @@ class ClusterVirtualClusterConfigAuxiliaryServicesConfigMetastoreConfig(dict):
     def dataproc_metastore_service(self) -> Optional[str]:
         """
         Resource name of an existing Dataproc Metastore service.
-
-        Only resource names including projectid and location (region) are valid. Examples:
-
-        `projects/[projectId]/locations/[dataproc_region]/services/[service-name]`
         """
         return pulumi.get(self, "dataproc_metastore_service")
 
@@ -3715,13 +3665,9 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
                  roles: Sequence[str],
                  node_pool_config: Optional['outputs.ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfig'] = None):
         """
-        :param str node_pool: The target GKE node pool.
-        :param Sequence[str] roles: Node group roles. 
-               One of `"DRIVER"`.
-        :param 'ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigArgs' node_pool_config: The configuration for the GKE node pool. 
-               If specified, Dataproc attempts to create a node pool with the specified shape.
-               If one with the same name already exists, it is verified against all specified fields.
-               If a field differs, the virtual cluster creation will fail.
+        :param str node_pool: The target GKE node pool. Format: 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{nodePool}'
+        :param Sequence[str] roles: The roles associated with the GKE node pool.
+        :param 'ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigArgs' node_pool_config: Input only. The configuration for the GKE node pool.
         """
         pulumi.set(__self__, "node_pool", node_pool)
         pulumi.set(__self__, "roles", roles)
@@ -3732,7 +3678,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter(name="nodePool")
     def node_pool(self) -> str:
         """
-        The target GKE node pool.
+        The target GKE node pool. Format: 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{nodePool}'
         """
         return pulumi.get(self, "node_pool")
 
@@ -3740,8 +3686,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter
     def roles(self) -> Sequence[str]:
         """
-        Node group roles. 
-        One of `"DRIVER"`.
+        The roles associated with the GKE node pool.
         """
         return pulumi.get(self, "roles")
 
@@ -3749,10 +3694,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter(name="nodePoolConfig")
     def node_pool_config(self) -> Optional['outputs.ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfig']:
         """
-        The configuration for the GKE node pool. 
-        If specified, Dataproc attempts to create a node pool with the specified shape.
-        If one with the same name already exists, it is verified against all specified fields.
-        If a field differs, the virtual cluster creation will fail.
+        Input only. The configuration for the GKE node pool.
         """
         return pulumi.get(self, "node_pool_config")
 
@@ -3764,11 +3706,8 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
                  autoscaling: Optional['outputs.ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigAutoscaling'] = None,
                  config: Optional['outputs.ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigConfig'] = None):
         """
-        :param Sequence[str] locations: The list of Compute Engine zones where node pool nodes associated 
-               with a Dataproc on GKE virtual cluster will be located.
-               - - -
-        :param 'ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigAutoscalingArgs' autoscaling: The autoscaler configuration for this node pool. 
-               The autoscaler is enabled only when a valid configuration is present.
+        :param Sequence[str] locations: The list of Compute Engine zones where node pool nodes associated with a Dataproc on GKE virtual cluster will be located.
+        :param 'ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigAutoscalingArgs' autoscaling: The autoscaler configuration for this node pool. The autoscaler is enabled only when a valid configuration is present.
         :param 'ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigConfigArgs' config: The node pool configuration.
         """
         pulumi.set(__self__, "locations", locations)
@@ -3781,9 +3720,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter
     def locations(self) -> Sequence[str]:
         """
-        The list of Compute Engine zones where node pool nodes associated 
-        with a Dataproc on GKE virtual cluster will be located.
-        - - -
+        The list of Compute Engine zones where node pool nodes associated with a Dataproc on GKE virtual cluster will be located.
         """
         return pulumi.get(self, "locations")
 
@@ -3791,8 +3728,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter
     def autoscaling(self) -> Optional['outputs.ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePoolTargetNodePoolConfigAutoscaling']:
         """
-        The autoscaler configuration for this node pool. 
-        The autoscaler is enabled only when a valid configuration is present.
+        The autoscaler configuration for this node pool. The autoscaler is enabled only when a valid configuration is present.
         """
         return pulumi.get(self, "autoscaling")
 
@@ -3885,18 +3821,10 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
                  preemptible: Optional[bool] = None,
                  spot: Optional[bool] = None):
         """
-        :param int local_ssd_count: The number of local SSD disks to attach to the node, 
-               which is limited by the maximum number of disks allowable per zone.
-        :param str machine_type: The name of a Google Compute Engine machine type
-               to create for the node group. If not specified, GCP will default to a predetermined
-               computed value (currently `n1-standard-4`).
-        :param str min_cpu_platform: The name of a minimum generation of CPU family
-               for the node group. If not specified, GCP will default to a predetermined computed value
-               for each zone. See [the guide](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
-               for details about which CPU families are available (and defaulted) for each zone.
-        :param bool preemptible: Whether the nodes are created as preemptible VM instances. 
-               Preemptible nodes cannot be used in a node pool with the CONTROLLER role or in the DEFAULT node pool if the
-               CONTROLLER role is not assigned (the DEFAULT node pool will assume the CONTROLLER role).
+        :param int local_ssd_count: The minimum number of nodes in the node pool. Must be >= 0 and <= maxNodeCount.
+        :param str machine_type: The name of a Compute Engine machine type.
+        :param str min_cpu_platform: Minimum CPU platform to be used by this instance. The instance may be scheduled on the specified or a newer CPU platform. Specify the friendly names of CPU platforms, such as "Intel Haswell" or "Intel Sandy Bridge".
+        :param bool preemptible: Whether the nodes are created as preemptible VM instances. Preemptible nodes cannot be used in a node pool with the CONTROLLER role or in the DEFAULT node pool if the CONTROLLER role is not assigned (the DEFAULT node pool will assume the CONTROLLER role).
         :param bool spot: Spot flag for enabling Spot VM, which is a rebrand of the existing preemptible flag.
         """
         if local_ssd_count is not None:
@@ -3914,8 +3842,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter(name="localSsdCount")
     def local_ssd_count(self) -> Optional[int]:
         """
-        The number of local SSD disks to attach to the node, 
-        which is limited by the maximum number of disks allowable per zone.
+        The minimum number of nodes in the node pool. Must be >= 0 and <= maxNodeCount.
         """
         return pulumi.get(self, "local_ssd_count")
 
@@ -3923,9 +3850,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter(name="machineType")
     def machine_type(self) -> Optional[str]:
         """
-        The name of a Google Compute Engine machine type
-        to create for the node group. If not specified, GCP will default to a predetermined
-        computed value (currently `n1-standard-4`).
+        The name of a Compute Engine machine type.
         """
         return pulumi.get(self, "machine_type")
 
@@ -3933,10 +3858,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter(name="minCpuPlatform")
     def min_cpu_platform(self) -> Optional[str]:
         """
-        The name of a minimum generation of CPU family
-        for the node group. If not specified, GCP will default to a predetermined computed value
-        for each zone. See [the guide](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
-        for details about which CPU families are available (and defaulted) for each zone.
+        Minimum CPU platform to be used by this instance. The instance may be scheduled on the specified or a newer CPU platform. Specify the friendly names of CPU platforms, such as "Intel Haswell" or "Intel Sandy Bridge".
         """
         return pulumi.get(self, "min_cpu_platform")
 
@@ -3944,9 +3866,7 @@ class ClusterVirtualClusterConfigKubernetesClusterConfigGkeClusterConfigNodePool
     @pulumi.getter
     def preemptible(self) -> Optional[bool]:
         """
-        Whether the nodes are created as preemptible VM instances. 
-        Preemptible nodes cannot be used in a node pool with the CONTROLLER role or in the DEFAULT node pool if the
-        CONTROLLER role is not assigned (the DEFAULT node pool will assume the CONTROLLER role).
+        Whether the nodes are created as preemptible VM instances. Preemptible nodes cannot be used in a node pool with the CONTROLLER role or in the DEFAULT node pool if the CONTROLLER role is not assigned (the DEFAULT node pool will assume the CONTROLLER role).
         """
         return pulumi.get(self, "preemptible")
 
@@ -9265,16 +9185,16 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
                  num_instances: Optional[int] = None,
                  preemptibility: Optional[str] = None):
         """
-        :param Sequence['WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigAcceleratorArgs'] accelerators: The Compute Engine accelerator configuration for these instances.
-        :param 'WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigDiskConfigArgs' disk_config: Disk option config settings.
-        :param str image: 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/` If the URI is unspecified, it will be inferred from `SoftwareConfig.image_version` or the system default.
+        :param Sequence['WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigAcceleratorArgs'] accelerators: Optional. The Compute Engine accelerator configuration for these instances.
+        :param 'WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigDiskConfigArgs' disk_config: Optional. Disk option config settings.
+        :param str image: 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.
         :param Sequence[str] instance_names: Output only. The list of instance names. Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group.
         :param bool is_preemptible: Output only. Specifies that this instance group contains preemptible instances.
-        :param str machine_type: 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/(https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
+        :param str machine_type: 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](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
         :param Sequence['WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigManagedGroupConfigArgs'] managed_group_configs: Output only. The config for Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
-        :param str min_cpu_platform: Specifies the minimum cpu platform for the Instance Group. See (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
-        :param int num_instances: The number of VM instances in the instance group. For master instance groups, must be set to 1.
-        :param str preemptibility: 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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
+        :param str min_cpu_platform: Optional. Specifies the minimum cpu platform for the Instance Group. See [Dataproc > Minimum CPU Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
+        :param int num_instances: Optional. The number of VM instances in the instance group. For [HA cluster](https://www.terraform.io/dataproc/docs/concepts/configuring-clusters/high-availability) master_config groups, **must be set to 3**. For standard cluster master_config groups, **must be set to 1**.
+        :param str preemptibility: 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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
         """
         if accelerators is not None:
             pulumi.set(__self__, "accelerators", accelerators)
@@ -9301,7 +9221,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter
     def accelerators(self) -> Optional[Sequence['outputs.WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigAccelerator']]:
         """
-        The Compute Engine accelerator configuration for these instances.
+        Optional. The Compute Engine accelerator configuration for these instances.
         """
         return pulumi.get(self, "accelerators")
 
@@ -9309,7 +9229,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter(name="diskConfig")
     def disk_config(self) -> Optional['outputs.WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfigDiskConfig']:
         """
-        Disk option config settings.
+        Optional. Disk option config settings.
         """
         return pulumi.get(self, "disk_config")
 
@@ -9317,7 +9237,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter
     def image(self) -> Optional[str]:
         """
-        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/` If the URI is unspecified, it will be inferred from `SoftwareConfig.image_version` or the system default.
+        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.
         """
         return pulumi.get(self, "image")
 
@@ -9341,7 +9261,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter(name="machineType")
     def machine_type(self) -> Optional[str]:
         """
-        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/(https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
+        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](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
         """
         return pulumi.get(self, "machine_type")
 
@@ -9357,7 +9277,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter(name="minCpuPlatform")
     def min_cpu_platform(self) -> Optional[str]:
         """
-        Specifies the minimum cpu platform for the Instance Group. See (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
+        Optional. Specifies the minimum cpu platform for the Instance Group. See [Dataproc > Minimum CPU Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
         """
         return pulumi.get(self, "min_cpu_platform")
 
@@ -9365,7 +9285,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter(name="numInstances")
     def num_instances(self) -> Optional[int]:
         """
-        The number of VM instances in the instance group. For master instance groups, must be set to 1.
+        Optional. The number of VM instances in the instance group. For [HA cluster](https://www.terraform.io/dataproc/docs/concepts/configuring-clusters/high-availability) master_config groups, **must be set to 3**. For standard cluster master_config groups, **must be set to 1**.
         """
         return pulumi.get(self, "num_instances")
 
@@ -9373,7 +9293,7 @@ class WorkflowTemplatePlacementManagedClusterConfigSecondaryWorkerConfig(dict):
     @pulumi.getter
     def preemptibility(self) -> Optional[str]:
         """
-        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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
+        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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
         """
         return pulumi.get(self, "preemptibility")
 
@@ -9939,16 +9859,16 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
                  num_instances: Optional[int] = None,
                  preemptibility: Optional[str] = None):
         """
-        :param Sequence['WorkflowTemplatePlacementManagedClusterConfigWorkerConfigAcceleratorArgs'] accelerators: The Compute Engine accelerator configuration for these instances.
-        :param 'WorkflowTemplatePlacementManagedClusterConfigWorkerConfigDiskConfigArgs' disk_config: Disk option config settings.
-        :param str image: 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/` If the URI is unspecified, it will be inferred from `SoftwareConfig.image_version` or the system default.
+        :param Sequence['WorkflowTemplatePlacementManagedClusterConfigWorkerConfigAcceleratorArgs'] accelerators: Optional. The Compute Engine accelerator configuration for these instances.
+        :param 'WorkflowTemplatePlacementManagedClusterConfigWorkerConfigDiskConfigArgs' disk_config: Optional. Disk option config settings.
+        :param str image: 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.
         :param Sequence[str] instance_names: Output only. The list of instance names. Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group.
         :param bool is_preemptible: Output only. Specifies that this instance group contains preemptible instances.
-        :param str machine_type: 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/(https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
+        :param str machine_type: 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](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
         :param Sequence['WorkflowTemplatePlacementManagedClusterConfigWorkerConfigManagedGroupConfigArgs'] managed_group_configs: Output only. The config for Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
-        :param str min_cpu_platform: Specifies the minimum cpu platform for the Instance Group. See (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
-        :param int num_instances: The number of VM instances in the instance group. For master instance groups, must be set to 1.
-        :param str preemptibility: 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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
+        :param str min_cpu_platform: Optional. Specifies the minimum cpu platform for the Instance Group. See [Dataproc > Minimum CPU Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
+        :param int num_instances: Optional. The number of VM instances in the instance group. For [HA cluster](https://www.terraform.io/dataproc/docs/concepts/configuring-clusters/high-availability) master_config groups, **must be set to 3**. For standard cluster master_config groups, **must be set to 1**.
+        :param str preemptibility: 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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
         """
         if accelerators is not None:
             pulumi.set(__self__, "accelerators", accelerators)
@@ -9975,7 +9895,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter
     def accelerators(self) -> Optional[Sequence['outputs.WorkflowTemplatePlacementManagedClusterConfigWorkerConfigAccelerator']]:
         """
-        The Compute Engine accelerator configuration for these instances.
+        Optional. The Compute Engine accelerator configuration for these instances.
         """
         return pulumi.get(self, "accelerators")
 
@@ -9983,7 +9903,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter(name="diskConfig")
     def disk_config(self) -> Optional['outputs.WorkflowTemplatePlacementManagedClusterConfigWorkerConfigDiskConfig']:
         """
-        Disk option config settings.
+        Optional. Disk option config settings.
         """
         return pulumi.get(self, "disk_config")
 
@@ -9991,7 +9911,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter
     def image(self) -> Optional[str]:
         """
-        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/` If the URI is unspecified, it will be inferred from `SoftwareConfig.image_version` or the system default.
+        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.
         """
         return pulumi.get(self, "image")
 
@@ -10015,7 +9935,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter(name="machineType")
     def machine_type(self) -> Optional[str]:
         """
-        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/(https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
+        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](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, `n1-standard-2`.
         """
         return pulumi.get(self, "machine_type")
 
@@ -10031,7 +9951,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter(name="minCpuPlatform")
     def min_cpu_platform(self) -> Optional[str]:
         """
-        Specifies the minimum cpu platform for the Instance Group. See (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
+        Optional. Specifies the minimum cpu platform for the Instance Group. See [Dataproc > Minimum CPU Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu).
         """
         return pulumi.get(self, "min_cpu_platform")
 
@@ -10039,7 +9959,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter(name="numInstances")
     def num_instances(self) -> Optional[int]:
         """
-        The number of VM instances in the instance group. For master instance groups, must be set to 1.
+        Optional. The number of VM instances in the instance group. For [HA cluster](https://www.terraform.io/dataproc/docs/concepts/configuring-clusters/high-availability) master_config groups, **must be set to 3**. For standard cluster master_config groups, **must be set to 1**.
         """
         return pulumi.get(self, "num_instances")
 
@@ -10047,7 +9967,7 @@ class WorkflowTemplatePlacementManagedClusterConfigWorkerConfig(dict):
     @pulumi.getter
     def preemptibility(self) -> Optional[str]:
         """
-        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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
+        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`. Possible values: PREEMPTIBILITY_UNSPECIFIED, NON_PREEMPTIBLE, PREEMPTIBLE
         """
         return pulumi.get(self, "preemptibility")