gcp.dataflow.Job
Explore with Pulumi AI
Creates a job on Dataflow, which is an implementation of Apache Beam running on Google Compute Engine. For more information see the official documentation for Beam and Dataflow.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const bigDataJob = new gcp.dataflow.Job("big_data_job", {
name: "dataflow-job",
templateGcsPath: "gs://my-bucket/templates/template_file",
tempGcsLocation: "gs://my-bucket/tmp_dir",
parameters: {
foo: "bar",
baz: "qux",
},
});
import pulumi
import pulumi_gcp as gcp
big_data_job = gcp.dataflow.Job("big_data_job",
name="dataflow-job",
template_gcs_path="gs://my-bucket/templates/template_file",
temp_gcs_location="gs://my-bucket/tmp_dir",
parameters={
"foo": "bar",
"baz": "qux",
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/dataflow"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := dataflow.NewJob(ctx, "big_data_job", &dataflow.JobArgs{
Name: pulumi.String("dataflow-job"),
TemplateGcsPath: pulumi.String("gs://my-bucket/templates/template_file"),
TempGcsLocation: pulumi.String("gs://my-bucket/tmp_dir"),
Parameters: pulumi.Map{
"foo": pulumi.Any("bar"),
"baz": pulumi.Any("qux"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var bigDataJob = new Gcp.Dataflow.Job("big_data_job", new()
{
Name = "dataflow-job",
TemplateGcsPath = "gs://my-bucket/templates/template_file",
TempGcsLocation = "gs://my-bucket/tmp_dir",
Parameters =
{
{ "foo", "bar" },
{ "baz", "qux" },
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.dataflow.Job;
import com.pulumi.gcp.dataflow.JobArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var bigDataJob = new Job("bigDataJob", JobArgs.builder()
.name("dataflow-job")
.templateGcsPath("gs://my-bucket/templates/template_file")
.tempGcsLocation("gs://my-bucket/tmp_dir")
.parameters(Map.ofEntries(
Map.entry("foo", "bar"),
Map.entry("baz", "qux")
))
.build());
}
}
resources:
bigDataJob:
type: gcp:dataflow:Job
name: big_data_job
properties:
name: dataflow-job
templateGcsPath: gs://my-bucket/templates/template_file
tempGcsLocation: gs://my-bucket/tmp_dir
parameters:
foo: bar
baz: qux
Streaming Job
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const topic = new gcp.pubsub.Topic("topic", {name: "dataflow-job1"});
const bucket1 = new gcp.storage.Bucket("bucket1", {
name: "tf-test-bucket1",
location: "US",
forceDestroy: true,
});
const bucket2 = new gcp.storage.Bucket("bucket2", {
name: "tf-test-bucket2",
location: "US",
forceDestroy: true,
});
const pubsubStream = new gcp.dataflow.Job("pubsub_stream", {
name: "tf-test-dataflow-job1",
templateGcsPath: "gs://my-bucket/templates/template_file",
tempGcsLocation: "gs://my-bucket/tmp_dir",
enableStreamingEngine: true,
parameters: {
inputFilePattern: pulumi.interpolate`${bucket1.url}/*.json`,
outputTopic: topic.id,
},
transformNameMapping: {
name: "test_job",
env: "test",
},
onDelete: "cancel",
});
import pulumi
import pulumi_gcp as gcp
topic = gcp.pubsub.Topic("topic", name="dataflow-job1")
bucket1 = gcp.storage.Bucket("bucket1",
name="tf-test-bucket1",
location="US",
force_destroy=True)
bucket2 = gcp.storage.Bucket("bucket2",
name="tf-test-bucket2",
location="US",
force_destroy=True)
pubsub_stream = gcp.dataflow.Job("pubsub_stream",
name="tf-test-dataflow-job1",
template_gcs_path="gs://my-bucket/templates/template_file",
temp_gcs_location="gs://my-bucket/tmp_dir",
enable_streaming_engine=True,
parameters={
"inputFilePattern": bucket1.url.apply(lambda url: f"{url}/*.json"),
"outputTopic": topic.id,
},
transform_name_mapping={
"name": "test_job",
"env": "test",
},
on_delete="cancel")
package main
import (
"fmt"
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/dataflow"
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/pubsub"
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/storage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
topic, err := pubsub.NewTopic(ctx, "topic", &pubsub.TopicArgs{
Name: pulumi.String("dataflow-job1"),
})
if err != nil {
return err
}
bucket1, err := storage.NewBucket(ctx, "bucket1", &storage.BucketArgs{
Name: pulumi.String("tf-test-bucket1"),
Location: pulumi.String("US"),
ForceDestroy: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = storage.NewBucket(ctx, "bucket2", &storage.BucketArgs{
Name: pulumi.String("tf-test-bucket2"),
Location: pulumi.String("US"),
ForceDestroy: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = dataflow.NewJob(ctx, "pubsub_stream", &dataflow.JobArgs{
Name: pulumi.String("tf-test-dataflow-job1"),
TemplateGcsPath: pulumi.String("gs://my-bucket/templates/template_file"),
TempGcsLocation: pulumi.String("gs://my-bucket/tmp_dir"),
EnableStreamingEngine: pulumi.Bool(true),
Parameters: pulumi.Map{
"inputFilePattern": bucket1.Url.ApplyT(func(url string) (string, error) {
return fmt.Sprintf("%v/*.json", url), nil
}).(pulumi.StringOutput),
"outputTopic": topic.ID(),
},
TransformNameMapping: pulumi.Map{
"name": pulumi.Any("test_job"),
"env": pulumi.Any("test"),
},
OnDelete: pulumi.String("cancel"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var topic = new Gcp.PubSub.Topic("topic", new()
{
Name = "dataflow-job1",
});
var bucket1 = new Gcp.Storage.Bucket("bucket1", new()
{
Name = "tf-test-bucket1",
Location = "US",
ForceDestroy = true,
});
var bucket2 = new Gcp.Storage.Bucket("bucket2", new()
{
Name = "tf-test-bucket2",
Location = "US",
ForceDestroy = true,
});
var pubsubStream = new Gcp.Dataflow.Job("pubsub_stream", new()
{
Name = "tf-test-dataflow-job1",
TemplateGcsPath = "gs://my-bucket/templates/template_file",
TempGcsLocation = "gs://my-bucket/tmp_dir",
EnableStreamingEngine = true,
Parameters =
{
{ "inputFilePattern", bucket1.Url.Apply(url => $"{url}/*.json") },
{ "outputTopic", topic.Id },
},
TransformNameMapping =
{
{ "name", "test_job" },
{ "env", "test" },
},
OnDelete = "cancel",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.pubsub.Topic;
import com.pulumi.gcp.pubsub.TopicArgs;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.dataflow.Job;
import com.pulumi.gcp.dataflow.JobArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var topic = new Topic("topic", TopicArgs.builder()
.name("dataflow-job1")
.build());
var bucket1 = new Bucket("bucket1", BucketArgs.builder()
.name("tf-test-bucket1")
.location("US")
.forceDestroy(true)
.build());
var bucket2 = new Bucket("bucket2", BucketArgs.builder()
.name("tf-test-bucket2")
.location("US")
.forceDestroy(true)
.build());
var pubsubStream = new Job("pubsubStream", JobArgs.builder()
.name("tf-test-dataflow-job1")
.templateGcsPath("gs://my-bucket/templates/template_file")
.tempGcsLocation("gs://my-bucket/tmp_dir")
.enableStreamingEngine(true)
.parameters(Map.ofEntries(
Map.entry("inputFilePattern", bucket1.url().applyValue(url -> String.format("%s/*.json", url))),
Map.entry("outputTopic", topic.id())
))
.transformNameMapping(Map.ofEntries(
Map.entry("name", "test_job"),
Map.entry("env", "test")
))
.onDelete("cancel")
.build());
}
}
resources:
topic:
type: gcp:pubsub:Topic
properties:
name: dataflow-job1
bucket1:
type: gcp:storage:Bucket
properties:
name: tf-test-bucket1
location: US
forceDestroy: true
bucket2:
type: gcp:storage:Bucket
properties:
name: tf-test-bucket2
location: US
forceDestroy: true
pubsubStream:
type: gcp:dataflow:Job
name: pubsub_stream
properties:
name: tf-test-dataflow-job1
templateGcsPath: gs://my-bucket/templates/template_file
tempGcsLocation: gs://my-bucket/tmp_dir
enableStreamingEngine: true
parameters:
inputFilePattern: ${bucket1.url}/*.json
outputTopic: ${topic.id}
transformNameMapping:
name: test_job
env: test
onDelete: cancel
Note on “destroy” / “apply”
There are many types of Dataflow jobs. Some Dataflow jobs run constantly, getting new data from (e.g.) a GCS bucket, and outputting data continuously. Some jobs process a set amount of data then terminate. All jobs can fail while running due to programming errors or other issues. In this way, Dataflow jobs are different from most other Google resources.
The Dataflow resource is considered ’existing’ while it is in a nonterminal state. If it reaches a terminal state (e.g. ‘FAILED’, ‘COMPLETE’, ‘CANCELLED’), it will be recreated on the next ‘apply’. This is as expected for jobs which run continuously, but may surprise users who use this resource for other kinds of Dataflow jobs.
A Dataflow job which is ‘destroyed’ may be “cancelled” or “drained”. If “cancelled”, the job terminates - any data written remains where it is, but no new data will be processed. If “drained”, no new data will enter the pipeline, but any data currently in the pipeline will finish being processed. The default is “drain”. When on_delete
is set to "drain"
in the configuration, you may experience a long wait for your pulumi destroy
to complete.
You can potentially short-circuit the wait by setting skip_wait_on_job_termination
to true
, but beware that unless you take active steps to ensure that the job name
parameter changes between instances, the name will conflict and the launch of the new job will fail. One way to do this is with a random_id resource, for example:
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
import * as random from "@pulumi/random";
const config = new pulumi.Config();
const bigDataJobSubscriptionId = config.get("bigDataJobSubscriptionId") || "projects/myproject/subscriptions/messages";
const bigDataJobNameSuffix = new random.RandomId("big_data_job_name_suffix", {
byteLength: 4,
keepers: {
region: region,
subscription_id: bigDataJobSubscriptionId,
},
});
const bigDataJob = new gcp.dataflow.FlexTemplateJob("big_data_job", {
name: pulumi.interpolate`dataflow-flextemplates-job-${bigDataJobNameSuffix.dec}`,
region: region,
containerSpecGcsPath: "gs://my-bucket/templates/template.json",
skipWaitOnJobTermination: true,
parameters: {
inputSubscription: bigDataJobSubscriptionId,
},
});
import pulumi
import pulumi_gcp as gcp
import pulumi_random as random
config = pulumi.Config()
big_data_job_subscription_id = config.get("bigDataJobSubscriptionId")
if big_data_job_subscription_id is None:
big_data_job_subscription_id = "projects/myproject/subscriptions/messages"
big_data_job_name_suffix = random.RandomId("big_data_job_name_suffix",
byte_length=4,
keepers={
"region": region,
"subscription_id": big_data_job_subscription_id,
})
big_data_job = gcp.dataflow.FlexTemplateJob("big_data_job",
name=big_data_job_name_suffix.dec.apply(lambda dec: f"dataflow-flextemplates-job-{dec}"),
region=region,
container_spec_gcs_path="gs://my-bucket/templates/template.json",
skip_wait_on_job_termination=True,
parameters={
"inputSubscription": big_data_job_subscription_id,
})
package main
import (
"fmt"
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/dataflow"
"github.com/pulumi/pulumi-random/sdk/v4/go/random"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
bigDataJobSubscriptionId := "projects/myproject/subscriptions/messages"
if param := cfg.Get("bigDataJobSubscriptionId"); param != "" {
bigDataJobSubscriptionId = param
}
bigDataJobNameSuffix, err := random.NewRandomId(ctx, "big_data_job_name_suffix", &random.RandomIdArgs{
ByteLength: pulumi.Int(4),
Keepers: pulumi.StringMap{
"region": pulumi.Any(region),
"subscription_id": pulumi.String(bigDataJobSubscriptionId),
},
})
if err != nil {
return err
}
_, err = dataflow.NewFlexTemplateJob(ctx, "big_data_job", &dataflow.FlexTemplateJobArgs{
Name: bigDataJobNameSuffix.Dec.ApplyT(func(dec string) (string, error) {
return fmt.Sprintf("dataflow-flextemplates-job-%v", dec), nil
}).(pulumi.StringOutput),
Region: pulumi.Any(region),
ContainerSpecGcsPath: pulumi.String("gs://my-bucket/templates/template.json"),
SkipWaitOnJobTermination: pulumi.Bool(true),
Parameters: pulumi.Map{
"inputSubscription": pulumi.String(bigDataJobSubscriptionId),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
using Random = Pulumi.Random;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var bigDataJobSubscriptionId = config.Get("bigDataJobSubscriptionId") ?? "projects/myproject/subscriptions/messages";
var bigDataJobNameSuffix = new Random.RandomId("big_data_job_name_suffix", new()
{
ByteLength = 4,
Keepers =
{
{ "region", region },
{ "subscription_id", bigDataJobSubscriptionId },
},
});
var bigDataJob = new Gcp.Dataflow.FlexTemplateJob("big_data_job", new()
{
Name = bigDataJobNameSuffix.Dec.Apply(dec => $"dataflow-flextemplates-job-{dec}"),
Region = region,
ContainerSpecGcsPath = "gs://my-bucket/templates/template.json",
SkipWaitOnJobTermination = true,
Parameters =
{
{ "inputSubscription", bigDataJobSubscriptionId },
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.random.RandomId;
import com.pulumi.random.RandomIdArgs;
import com.pulumi.gcp.dataflow.FlexTemplateJob;
import com.pulumi.gcp.dataflow.FlexTemplateJobArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var config = ctx.config();
final var bigDataJobSubscriptionId = config.get("bigDataJobSubscriptionId").orElse("projects/myproject/subscriptions/messages");
var bigDataJobNameSuffix = new RandomId("bigDataJobNameSuffix", RandomIdArgs.builder()
.byteLength(4)
.keepers(Map.ofEntries(
Map.entry("region", region),
Map.entry("subscription_id", bigDataJobSubscriptionId)
))
.build());
var bigDataJob = new FlexTemplateJob("bigDataJob", FlexTemplateJobArgs.builder()
.name(bigDataJobNameSuffix.dec().applyValue(dec -> String.format("dataflow-flextemplates-job-%s", dec)))
.region(region)
.containerSpecGcsPath("gs://my-bucket/templates/template.json")
.skipWaitOnJobTermination(true)
.parameters(Map.of("inputSubscription", bigDataJobSubscriptionId))
.build());
}
}
configuration:
bigDataJobSubscriptionId:
type: string
default: projects/myproject/subscriptions/messages
resources:
bigDataJobNameSuffix:
type: random:RandomId
name: big_data_job_name_suffix
properties:
byteLength: 4
keepers:
region: ${region}
subscription_id: ${bigDataJobSubscriptionId}
bigDataJob:
type: gcp:dataflow:FlexTemplateJob
name: big_data_job
properties:
name: dataflow-flextemplates-job-${bigDataJobNameSuffix.dec}
region: ${region}
containerSpecGcsPath: gs://my-bucket/templates/template.json
skipWaitOnJobTermination: true
parameters:
inputSubscription: ${bigDataJobSubscriptionId}
Create Job Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Job(name: string, args: JobArgs, opts?: CustomResourceOptions);
@overload
def Job(resource_name: str,
args: JobArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Job(resource_name: str,
opts: Optional[ResourceOptions] = None,
temp_gcs_location: Optional[str] = None,
template_gcs_path: Optional[str] = None,
parameters: Optional[Mapping[str, Any]] = None,
project: Optional[str] = None,
labels: Optional[Mapping[str, Any]] = None,
machine_type: Optional[str] = None,
max_workers: Optional[int] = None,
name: Optional[str] = None,
network: Optional[str] = None,
on_delete: Optional[str] = None,
additional_experiments: Optional[Sequence[str]] = None,
kms_key_name: Optional[str] = None,
region: Optional[str] = None,
service_account_email: Optional[str] = None,
skip_wait_on_job_termination: Optional[bool] = None,
subnetwork: Optional[str] = None,
ip_configuration: Optional[str] = None,
enable_streaming_engine: Optional[bool] = None,
transform_name_mapping: Optional[Mapping[str, Any]] = None,
zone: Optional[str] = None)
func NewJob(ctx *Context, name string, args JobArgs, opts ...ResourceOption) (*Job, error)
public Job(string name, JobArgs args, CustomResourceOptions? opts = null)
type: gcp:dataflow:Job
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args JobArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args JobArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args JobArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args JobArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args JobArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var examplejobResourceResourceFromDataflowjob = new Gcp.Dataflow.Job("examplejobResourceResourceFromDataflowjob", new()
{
TempGcsLocation = "string",
TemplateGcsPath = "string",
Parameters =
{
{ "string", "any" },
},
Project = "string",
Labels =
{
{ "string", "any" },
},
MachineType = "string",
MaxWorkers = 0,
Name = "string",
Network = "string",
OnDelete = "string",
AdditionalExperiments = new[]
{
"string",
},
KmsKeyName = "string",
Region = "string",
ServiceAccountEmail = "string",
SkipWaitOnJobTermination = false,
Subnetwork = "string",
IpConfiguration = "string",
EnableStreamingEngine = false,
TransformNameMapping =
{
{ "string", "any" },
},
Zone = "string",
});
example, err := dataflow.NewJob(ctx, "examplejobResourceResourceFromDataflowjob", &dataflow.JobArgs{
TempGcsLocation: pulumi.String("string"),
TemplateGcsPath: pulumi.String("string"),
Parameters: pulumi.Map{
"string": pulumi.Any("any"),
},
Project: pulumi.String("string"),
Labels: pulumi.Map{
"string": pulumi.Any("any"),
},
MachineType: pulumi.String("string"),
MaxWorkers: pulumi.Int(0),
Name: pulumi.String("string"),
Network: pulumi.String("string"),
OnDelete: pulumi.String("string"),
AdditionalExperiments: pulumi.StringArray{
pulumi.String("string"),
},
KmsKeyName: pulumi.String("string"),
Region: pulumi.String("string"),
ServiceAccountEmail: pulumi.String("string"),
SkipWaitOnJobTermination: pulumi.Bool(false),
Subnetwork: pulumi.String("string"),
IpConfiguration: pulumi.String("string"),
EnableStreamingEngine: pulumi.Bool(false),
TransformNameMapping: pulumi.Map{
"string": pulumi.Any("any"),
},
Zone: pulumi.String("string"),
})
var examplejobResourceResourceFromDataflowjob = new Job("examplejobResourceResourceFromDataflowjob", JobArgs.builder()
.tempGcsLocation("string")
.templateGcsPath("string")
.parameters(Map.of("string", "any"))
.project("string")
.labels(Map.of("string", "any"))
.machineType("string")
.maxWorkers(0)
.name("string")
.network("string")
.onDelete("string")
.additionalExperiments("string")
.kmsKeyName("string")
.region("string")
.serviceAccountEmail("string")
.skipWaitOnJobTermination(false)
.subnetwork("string")
.ipConfiguration("string")
.enableStreamingEngine(false)
.transformNameMapping(Map.of("string", "any"))
.zone("string")
.build());
examplejob_resource_resource_from_dataflowjob = gcp.dataflow.Job("examplejobResourceResourceFromDataflowjob",
temp_gcs_location="string",
template_gcs_path="string",
parameters={
"string": "any",
},
project="string",
labels={
"string": "any",
},
machine_type="string",
max_workers=0,
name="string",
network="string",
on_delete="string",
additional_experiments=["string"],
kms_key_name="string",
region="string",
service_account_email="string",
skip_wait_on_job_termination=False,
subnetwork="string",
ip_configuration="string",
enable_streaming_engine=False,
transform_name_mapping={
"string": "any",
},
zone="string")
const examplejobResourceResourceFromDataflowjob = new gcp.dataflow.Job("examplejobResourceResourceFromDataflowjob", {
tempGcsLocation: "string",
templateGcsPath: "string",
parameters: {
string: "any",
},
project: "string",
labels: {
string: "any",
},
machineType: "string",
maxWorkers: 0,
name: "string",
network: "string",
onDelete: "string",
additionalExperiments: ["string"],
kmsKeyName: "string",
region: "string",
serviceAccountEmail: "string",
skipWaitOnJobTermination: false,
subnetwork: "string",
ipConfiguration: "string",
enableStreamingEngine: false,
transformNameMapping: {
string: "any",
},
zone: "string",
});
type: gcp:dataflow:Job
properties:
additionalExperiments:
- string
enableStreamingEngine: false
ipConfiguration: string
kmsKeyName: string
labels:
string: any
machineType: string
maxWorkers: 0
name: string
network: string
onDelete: string
parameters:
string: any
project: string
region: string
serviceAccountEmail: string
skipWaitOnJobTermination: false
subnetwork: string
tempGcsLocation: string
templateGcsPath: string
transformNameMapping:
string: any
zone: string
Job Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Job resource accepts the following input properties:
- Temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- Template
Gcs stringPath - The GCS path to the Dataflow job template.
- Additional
Experiments List<string> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - Enable
Streaming boolEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- Ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - Kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- Labels Dictionary<string, object>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - Machine
Type string - The machine type to use for the job.
- Max
Workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- Name string
- A unique name for the resource, required by Dataflow.
- Network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- On
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - Parameters Dictionary<string, object>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- Project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region in which the created job should run.
- Service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - Skip
Wait boolOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - Subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- Transform
Name Dictionary<string, object>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- Zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- Temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- Template
Gcs stringPath - The GCS path to the Dataflow job template.
- Additional
Experiments []string - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - Enable
Streaming boolEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- Ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - Kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- Labels map[string]interface{}
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - Machine
Type string - The machine type to use for the job.
- Max
Workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- Name string
- A unique name for the resource, required by Dataflow.
- Network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- On
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - Parameters map[string]interface{}
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- Project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region in which the created job should run.
- Service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - Skip
Wait boolOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - Subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- Transform
Name map[string]interface{}Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- Zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- temp
Gcs StringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs StringPath - The GCS path to the Dataflow job template.
- additional
Experiments List<String> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - enable
Streaming BooleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration String - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - kms
Key StringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Map<String,Object>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type String - The machine type to use for the job.
- max
Workers Integer - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name String
- A unique name for the resource, required by Dataflow.
- network String
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete String - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Map<String,Object>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project String
- The project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region in which the created job should run.
- service
Account StringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait BooleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - subnetwork String
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- transform
Name Map<String,Object>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- zone String
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs stringPath - The GCS path to the Dataflow job template.
- additional
Experiments string[] - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - enable
Streaming booleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels {[key: string]: any}
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type string - The machine type to use for the job.
- max
Workers number - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name string
- A unique name for the resource, required by Dataflow.
- network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters {[key: string]: any}
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- The region in which the created job should run.
- service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait booleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- transform
Name {[key: string]: any}Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- temp_
gcs_ strlocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template_
gcs_ strpath - The GCS path to the Dataflow job template.
- additional_
experiments Sequence[str] - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - enable_
streaming_ boolengine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip_
configuration str - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - kms_
key_ strname - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Mapping[str, Any]
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine_
type str - The machine type to use for the job.
- max_
workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name str
- A unique name for the resource, required by Dataflow.
- network str
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on_
delete str - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Mapping[str, Any]
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project str
- The project in which the resource belongs. If it is not provided, the provider project is used.
- region str
- The region in which the created job should run.
- service_
account_ stremail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip_
wait_ boolon_ job_ termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - subnetwork str
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- transform_
name_ Mapping[str, Any]mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- zone str
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- temp
Gcs StringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs StringPath - The GCS path to the Dataflow job template.
- additional
Experiments List<String> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - enable
Streaming BooleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration String - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - kms
Key StringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Map<Any>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type String - The machine type to use for the job.
- max
Workers Number - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name String
- A unique name for the resource, required by Dataflow.
- network String
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete String - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Map<Any>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project String
- The project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region in which the created job should run.
- service
Account StringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait BooleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - subnetwork String
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- transform
Name Map<Any>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- zone String
- The zone in which the created job should run. If it is not provided, the provider zone is used.
Outputs
All input properties are implicitly available as output properties. Additionally, the Job resource produces the following output properties:
- Effective
Labels Dictionary<string, string> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Id string
- The provider-assigned unique ID for this managed resource.
- Job
Id string - The unique ID of this job.
- Pulumi
Labels Dictionary<string, string> - The combination of labels configured directly on the resource and default labels configured on the provider.
- State string
- The current state of the resource, selected from the JobState enum
- Type string
- The type of this job, selected from the JobType enum
- Effective
Labels map[string]string - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Id string
- The provider-assigned unique ID for this managed resource.
- Job
Id string - The unique ID of this job.
- Pulumi
Labels map[string]string - The combination of labels configured directly on the resource and default labels configured on the provider.
- State string
- The current state of the resource, selected from the JobState enum
- Type string
- The type of this job, selected from the JobType enum
- effective
Labels Map<String,String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id String
- The provider-assigned unique ID for this managed resource.
- job
Id String - The unique ID of this job.
- pulumi
Labels Map<String,String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- state String
- The current state of the resource, selected from the JobState enum
- type String
- The type of this job, selected from the JobType enum
- effective
Labels {[key: string]: string} - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id string
- The provider-assigned unique ID for this managed resource.
- job
Id string - The unique ID of this job.
- pulumi
Labels {[key: string]: string} - The combination of labels configured directly on the resource and default labels configured on the provider.
- state string
- The current state of the resource, selected from the JobState enum
- type string
- The type of this job, selected from the JobType enum
- effective_
labels Mapping[str, str] - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id str
- The provider-assigned unique ID for this managed resource.
- job_
id str - The unique ID of this job.
- pulumi_
labels Mapping[str, str] - The combination of labels configured directly on the resource and default labels configured on the provider.
- state str
- The current state of the resource, selected from the JobState enum
- type str
- The type of this job, selected from the JobType enum
- effective
Labels Map<String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id String
- The provider-assigned unique ID for this managed resource.
- job
Id String - The unique ID of this job.
- pulumi
Labels Map<String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- state String
- The current state of the resource, selected from the JobState enum
- type String
- The type of this job, selected from the JobType enum
Look up Existing Job Resource
Get an existing Job resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: JobState, opts?: CustomResourceOptions): Job
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
additional_experiments: Optional[Sequence[str]] = None,
effective_labels: Optional[Mapping[str, str]] = None,
enable_streaming_engine: Optional[bool] = None,
ip_configuration: Optional[str] = None,
job_id: Optional[str] = None,
kms_key_name: Optional[str] = None,
labels: Optional[Mapping[str, Any]] = None,
machine_type: Optional[str] = None,
max_workers: Optional[int] = None,
name: Optional[str] = None,
network: Optional[str] = None,
on_delete: Optional[str] = None,
parameters: Optional[Mapping[str, Any]] = None,
project: Optional[str] = None,
pulumi_labels: Optional[Mapping[str, str]] = None,
region: Optional[str] = None,
service_account_email: Optional[str] = None,
skip_wait_on_job_termination: Optional[bool] = None,
state: Optional[str] = None,
subnetwork: Optional[str] = None,
temp_gcs_location: Optional[str] = None,
template_gcs_path: Optional[str] = None,
transform_name_mapping: Optional[Mapping[str, Any]] = None,
type: Optional[str] = None,
zone: Optional[str] = None) -> Job
func GetJob(ctx *Context, name string, id IDInput, state *JobState, opts ...ResourceOption) (*Job, error)
public static Job Get(string name, Input<string> id, JobState? state, CustomResourceOptions? opts = null)
public static Job get(String name, Output<String> id, JobState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Additional
Experiments List<string> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - Effective
Labels Dictionary<string, string> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Enable
Streaming boolEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- Ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - Job
Id string - The unique ID of this job.
- Kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- Labels Dictionary<string, object>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - Machine
Type string - The machine type to use for the job.
- Max
Workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- Name string
- A unique name for the resource, required by Dataflow.
- Network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- On
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - Parameters Dictionary<string, object>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- Project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- Pulumi
Labels Dictionary<string, string> - The combination of labels configured directly on the resource and default labels configured on the provider.
- Region string
- The region in which the created job should run.
- Service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - Skip
Wait boolOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - State string
- The current state of the resource, selected from the JobState enum
- Subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- Temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- Template
Gcs stringPath - The GCS path to the Dataflow job template.
- Transform
Name Dictionary<string, object>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- Type string
- The type of this job, selected from the JobType enum
- Zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- Additional
Experiments []string - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - Effective
Labels map[string]string - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Enable
Streaming boolEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- Ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - Job
Id string - The unique ID of this job.
- Kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- Labels map[string]interface{}
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - Machine
Type string - The machine type to use for the job.
- Max
Workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- Name string
- A unique name for the resource, required by Dataflow.
- Network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- On
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - Parameters map[string]interface{}
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- Project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- Pulumi
Labels map[string]string - The combination of labels configured directly on the resource and default labels configured on the provider.
- Region string
- The region in which the created job should run.
- Service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - Skip
Wait boolOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - State string
- The current state of the resource, selected from the JobState enum
- Subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- Temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- Template
Gcs stringPath - The GCS path to the Dataflow job template.
- Transform
Name map[string]interface{}Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- Type string
- The type of this job, selected from the JobType enum
- Zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- additional
Experiments List<String> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - effective
Labels Map<String,String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- enable
Streaming BooleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration String - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - job
Id String - The unique ID of this job.
- kms
Key StringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Map<String,Object>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type String - The machine type to use for the job.
- max
Workers Integer - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name String
- A unique name for the resource, required by Dataflow.
- network String
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete String - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Map<String,Object>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project String
- The project in which the resource belongs. If it is not provided, the provider project is used.
- pulumi
Labels Map<String,String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- region String
- The region in which the created job should run.
- service
Account StringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait BooleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - state String
- The current state of the resource, selected from the JobState enum
- subnetwork String
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- temp
Gcs StringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs StringPath - The GCS path to the Dataflow job template.
- transform
Name Map<String,Object>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- type String
- The type of this job, selected from the JobType enum
- zone String
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- additional
Experiments string[] - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - effective
Labels {[key: string]: string} - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- enable
Streaming booleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration string - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - job
Id string - The unique ID of this job.
- kms
Key stringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels {[key: string]: any}
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type string - The machine type to use for the job.
- max
Workers number - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name string
- A unique name for the resource, required by Dataflow.
- network string
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete string - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters {[key: string]: any}
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project string
- The project in which the resource belongs. If it is not provided, the provider project is used.
- pulumi
Labels {[key: string]: string} - The combination of labels configured directly on the resource and default labels configured on the provider.
- region string
- The region in which the created job should run.
- service
Account stringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait booleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - state string
- The current state of the resource, selected from the JobState enum
- subnetwork string
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- temp
Gcs stringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs stringPath - The GCS path to the Dataflow job template.
- transform
Name {[key: string]: any}Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- type string
- The type of this job, selected from the JobType enum
- zone string
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- additional_
experiments Sequence[str] - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - effective_
labels Mapping[str, str] - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- enable_
streaming_ boolengine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip_
configuration str - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - job_
id str - The unique ID of this job.
- kms_
key_ strname - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Mapping[str, Any]
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine_
type str - The machine type to use for the job.
- max_
workers int - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name str
- A unique name for the resource, required by Dataflow.
- network str
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on_
delete str - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Mapping[str, Any]
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project str
- The project in which the resource belongs. If it is not provided, the provider project is used.
- pulumi_
labels Mapping[str, str] - The combination of labels configured directly on the resource and default labels configured on the provider.
- region str
- The region in which the created job should run.
- service_
account_ stremail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip_
wait_ boolon_ job_ termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - state str
- The current state of the resource, selected from the JobState enum
- subnetwork str
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- temp_
gcs_ strlocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template_
gcs_ strpath - The GCS path to the Dataflow job template.
- transform_
name_ Mapping[str, Any]mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- type str
- The type of this job, selected from the JobType enum
- zone str
- The zone in which the created job should run. If it is not provided, the provider zone is used.
- additional
Experiments List<String> - List of experiments that should be used by the job. An example value is
["enable_stackdriver_agent_metrics"]
. - effective
Labels Map<String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- enable
Streaming BooleanEngine - Enable/disable the use of Streaming Engine for the job. Note that Streaming Engine is enabled by default for pipelines developed against the Beam SDK for Python v2.21.0 or later when using Python 3.
- ip
Configuration String - The configuration for VM IPs. Options are
"WORKER_IP_PUBLIC"
or"WORKER_IP_PRIVATE"
. - job
Id String - The unique ID of this job.
- kms
Key StringName - The name for the Cloud KMS key for the job. Key format is:
projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY
- labels Map<Any>
- User labels to be specified for the job. Keys and values should follow the restrictions
specified in the labeling restrictions page.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource. - machine
Type String - The machine type to use for the job.
- max
Workers Number - The number of workers permitted to work on the job. More workers may improve processing speed at additional cost.
- name String
- A unique name for the resource, required by Dataflow.
- network String
- The network to which VMs will be assigned. If it is not provided, "default" will be used.
- on
Delete String - One of "drain" or "cancel". Specifies behavior of deletion during
pulumi destroy
. See above note. - parameters Map<Any>
- Template specific Key/Value pairs to be forwarded to the pipeline's options; keys are case-sensitive based on the language on which the pipeline is coded, mostly Java. Note: do not configure Dataflow options here in parameters.
- project String
- The project in which the resource belongs. If it is not provided, the provider project is used.
- pulumi
Labels Map<String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- region String
- The region in which the created job should run.
- service
Account StringEmail - The Service Account email used to create the job. This should be just an email e.g.
myserviceaccount@myproject.iam.gserviceaccount.com
. Do not include anyserviceAccount:
or other prefix. - skip
Wait BooleanOn Job Termination - If set to
true
, Pulumi will treatDRAINING
andCANCELLING
as terminal states when deleting the resource, and will remove the resource from Pulumi state and move on. See above note. - state String
- The current state of the resource, selected from the JobState enum
- subnetwork String
- The subnetwork to which VMs will be assigned. Should be of the form "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL. For example
"googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
- temp
Gcs StringLocation - A writeable location on GCS for the Dataflow job to dump its temporary data.
- template
Gcs StringPath - The GCS path to the Dataflow job template.
- transform
Name Map<Any>Mapping - Only applicable when updating a pipeline. Map of transform name prefixes of the job to be replaced with the corresponding name prefixes of the new job. This field is not used outside of update.
- type String
- The type of this job, selected from the JobType enum
- zone String
- The zone in which the created job should run. If it is not provided, the provider zone is used.
Import
Dataflow jobs can be imported using the job id
e.g.
{{id}}
When using the pulumi import
command, dataflow jobs can be imported using one of the formats above. For example:
$ pulumi import gcp:dataflow/job:Job default {{id}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.