Google Cloud Dataplex V1 Client - Class RunTaskRequest (1.11.0)

Reference documentation and code samples for the Google Cloud Dataplex V1 Client class RunTaskRequest.

Generated from protobuf messagegoogle.cloud.dataplex.v1.RunTaskRequest

Namespace

Google \ Cloud \ Dataplex \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
dataarray

Optional. Data for populating the Message object.

↳ namestring

Required. The resource name of the task:projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}.

↳ labelsarray|Google\Protobuf\Internal\MapField

Optional. User-defined labels for the task. If the map is left empty, the task will run with existing labels from task definition. If the map contains an entry with a new key, the same will be added to existing set of labels. If the map contains an entry with an existing label key in task definition, the task will run with new label value for that entry. Clearing an existing label will require label value to be explicitly set to a hyphen "-". The label value cannot be empty.

↳ argsarray|Google\Protobuf\Internal\MapField

Optional. Execution spec arguments. If the map is left empty, the task will run with existing execution spec args from task definition. If the map contains an entry with a new key, the same will be added to existing set of args. If the map contains an entry with an existing arg key in task definition, the task will run with new arg value for that entry. Clearing an existing arg will require arg value to be explicitly set to a hyphen "-". The arg value cannot be empty.

getName

Required. The resource name of the task:projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}.

Returns
TypeDescription
string

setName

Required. The resource name of the task:projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}.

Parameter
NameDescription
varstring
Returns
TypeDescription
$this

getLabels

Optional. User-defined labels for the task. If the map is left empty, thetask will run with existing labels from task definition. If the mapcontains an entry with a new key, the same will be added to existing set oflabels. If the map contains an entry with an existing label key in taskdefinition, the task will run with new label value for that entry. Clearingan existing label will require label value to be explicitly set to a hyphen"-". The label value cannot be empty.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

Optional. User-defined labels for the task. If the map is left empty, thetask will run with existing labels from task definition. If the mapcontains an entry with a new key, the same will be added to existing set oflabels. If the map contains an entry with an existing label key in taskdefinition, the task will run with new label value for that entry. Clearingan existing label will require label value to be explicitly set to a hyphen"-". The label value cannot be empty.

Parameter
NameDescription
vararray|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getArgs

Optional. Execution spec arguments. If the map is left empty, the task willrun with existing execution spec args from task definition. If the mapcontains an entry with a new key, the same will be added to existing set ofargs. If the map contains an entry with an existing arg key in taskdefinition, the task will run with new arg value for that entry. Clearingan existing arg will require arg value to be explicitly set to a hyphen"-". The arg value cannot be empty.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setArgs

Optional. Execution spec arguments. If the map is left empty, the task willrun with existing execution spec args from task definition. If the mapcontains an entry with a new key, the same will be added to existing set ofargs. If the map contains an entry with an existing arg key in taskdefinition, the task will run with new arg value for that entry. Clearingan existing arg will require arg value to be explicitly set to a hyphen"-". The arg value cannot be empty.

Parameter
NameDescription
vararray|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

static::build

Parameter
NameDescription
namestring

Required. The resource name of the task:projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}. Please seeDataplexServiceClient::taskName() for help formatting this field.

Returns
TypeDescription
RunTaskRequest

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-08 UTC.