Launch a Flex Template asynchronously
Stay organized with collections
Save and categorize content based on your preferences.
Demonstrates how to launch a Flex Template asynchronously.
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis page provides code examples demonstrating how to asynchronously launch a Flex Template using the Google Cloud Dataflow service.\u003c/p\u003e\n"],["\u003cp\u003eCode samples are provided in C#, Java, Node.js, and Python, illustrating the implementation in multiple popular programming languages.\u003c/p\u003e\n"],["\u003cp\u003eEach code sample guides users to set up Application Default Credentials for Dataflow authentication.\u003c/p\u003e\n"],["\u003cp\u003eThe examples highlight the use of the \u003ccode\u003eLaunchFlexTemplateAsync\u003c/code\u003e method to initiate the Flex Template launch in different coding contexts.\u003c/p\u003e\n"],["\u003cp\u003eThe document references the Google Cloud sample browser, as a way to find other product related samples.\u003c/p\u003e\n"]]],[],null,["# Launch a Flex Template asynchronously\n\nDemonstrates how to launch a Flex Template asynchronously.\n\nCode sample\n-----------\n\n### C#\n\n\nTo authenticate to Dataflow, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n using https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.html;\n using System.Threading.Tasks;\n\n public sealed partial class GeneratedFlexTemplatesServiceClientSnippets\n {\n /// \u003csummary\u003eSnippet for LaunchFlexTemplateAsync\u003c/summary\u003e\n /// \u003cremarks\u003e\n /// This snippet has been automatically generated and should be regarded as a code template only.\n /// It will require modifications to work:\n /// - It may require correct/in-range values for request initialization.\n /// - It may require specifying regional endpoints when creating the service client as shown in\n /// https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.\n /// \u003c/remarks\u003e\n public async Task LaunchFlexTemplateRequestObjectAsync()\n {\n // Create client\n https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.FlexTemplatesServiceClient.html flexTemplatesServiceClient = await https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.FlexTemplatesServiceClient.html.https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.FlexTemplatesServiceClient.html#Google_Cloud_Dataflow_V1Beta3_FlexTemplatesServiceClient_CreateAsync_System_Threading_CancellationToken_();\n // Initialize request argument(s)\n https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.LaunchFlexTemplateRequest.html request = new https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.LaunchFlexTemplateRequest.html\n {\n ProjectId = \"\",\n LaunchParameter = new https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.LaunchFlexTemplateParameter.html(),\n Location = \"\",\n ValidateOnly = false,\n };\n // Make the request\n https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.LaunchFlexTemplateResponse.html response = await flexTemplatesServiceClient.https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Dataflow.V1Beta3/latest/Google.Cloud.Dataflow.V1Beta3.FlexTemplatesServiceClient.html#Google_Cloud_Dataflow_V1Beta3_FlexTemplatesServiceClient_LaunchFlexTemplateAsync_Google_Cloud_Dataflow_V1Beta3_LaunchFlexTemplateRequest_Google_Api_Gax_Grpc_CallSettings_(request);\n }\n }\n\n### Java\n\n\nTo authenticate to Dataflow, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n import com.google.api.core.https://cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.ApiFuture.html;\n import com.google.dataflow.v1beta3.FlexTemplatesServiceClient;\n import com.google.dataflow.v1beta3.LaunchFlexTemplateParameter;\n import com.google.dataflow.v1beta3.LaunchFlexTemplateRequest;\n import com.google.dataflow.v1beta3.LaunchFlexTemplateResponse;\n\n public class AsyncLaunchFlexTemplate {\n\n public static void main(String[] args) throws Exception {\n asyncLaunchFlexTemplate();\n }\n\n public static void asyncLaunchFlexTemplate() throws Exception {\n // This snippet has been automatically generated and should be regarded as a code template only.\n // It will require modifications to work:\n // - It may require correct/in-range values for request initialization.\n // - It may require specifying regional endpoints when creating the service client as shown in\n // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n try (FlexTemplatesServiceClient flexTemplatesServiceClient =\n FlexTemplatesServiceClient.https://cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.SettableApiFuture.html#com_google_api_core_SettableApiFuture__V_create__()) {\n LaunchFlexTemplateRequest request =\n LaunchFlexTemplateRequest.newBuilder()\n .setProjectId(\"projectId-894832108\")\n .setLaunchParameter(LaunchFlexTemplateParameter.newBuilder().build())\n .setLocation(\"location1901043637\")\n .setValidateOnly(true)\n .build();\n ApiFuture\u003cLaunchFlexTemplateResponse\u003e future =\n flexTemplatesServiceClient.launchFlexTemplateCallable().futureCall(request);\n // Do something.\n LaunchFlexTemplateResponse response = future.get();\n }\n }\n }\n\n### Node.js\n\n\nTo authenticate to Dataflow, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n /**\n * This snippet has been automatically generated and should be regarded as a code template only.\n * It will require modifications to work.\n * It may require correct/in-range values for request initialization.\n * TODO(developer): Uncomment these variables before running the sample.\n */\n /**\n * Required. The ID of the Cloud Platform project that the job belongs to.\n */\n // const projectId = 'abc123'\n /**\n * Required. Parameter to launch a job form Flex Template.\n */\n // const launchParameter = {}\n /**\n * Required. The regional endpoint \n * (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to\n * which to direct the request. E.g., us-central1, us-west1.\n */\n // const location = 'abc123'\n /**\n * If true, the request is validated but not actually executed.\n * Defaults to false.\n */\n // const validateOnly = true\n\n // Imports the Dataflow library\n const {FlexTemplatesServiceClient} = require('https://cloud.google.com/nodejs/docs/reference/dataflow/latest/overview.html').v1beta3;\n\n // Instantiates a client\n const dataflowClient = new https://cloud.google.com/nodejs/docs/reference/dataflow/latest/overview.html();\n\n async function callLaunchFlexTemplate() {\n // Construct request\n const request = {\n };\n\n // Run request\n const response = await dataflowClient.launchFlexTemplate(request);\n console.log(response);\n }\n\n callLaunchFlexTemplate();\n\n### Python\n\n\nTo authenticate to Dataflow, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n # This snippet has been automatically generated and should be regarded as a\n # code template only.\n # It will require modifications to work:\n # - It may require correct/in-range values for request initialization.\n # - It may require specifying regional endpoints when creating the service\n # client as shown in:\n # https://googleapis.dev/python/google-api-core/latest/client_options.html\n from google.cloud import https://cloud.google.com/python/docs/reference/dataflow/latest/\n\n\n async def sample_launch_flex_template():\n # Create a client\n client = https://cloud.google.com/python/docs/reference/dataflow/latest/.https://cloud.google.com/python/docs/reference/dataflow/latest/google.cloud.dataflow_v1beta3.services.flex_templates_service.FlexTemplatesServiceAsyncClient.html()\n\n # Initialize request argument(s)\n request = https://cloud.google.com/python/docs/reference/dataflow/latest/.https://cloud.google.com/python/docs/reference/dataflow/latest/google.cloud.dataflow_v1beta3.types.LaunchFlexTemplateRequest.html(\n )\n\n # Make the request\n response = await client.https://cloud.google.com/python/docs/reference/dataflow/latest/google.cloud.dataflow_v1beta3.services.flex_templates_service.FlexTemplatesServiceAsyncClient.html#google_cloud_dataflow_v1beta3_services_flex_templates_service_FlexTemplatesServiceAsyncClient_launch_flex_template(request=request)\n\n # Handle the response\n print(response)\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=dataflow)."]]