mirror of
https://github.com/OMGeeky/google-apis-rs.git
synced 2026-01-25 12:44:07 +01:00
614 lines
28 KiB
HTML
614 lines
28 KiB
HTML
<!DOCTYPE html>
|
|
<html class="writer-html5" lang="en" >
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="http://byron.github.io/google-apis-rs/google-datapipelines1-cli/projects_locations-pipelines-patch/" />
|
|
<link rel="shortcut icon" href="../img/favicon.ico" />
|
|
<title>Locations Pipelines Patch - Datapipelines v5.0.4+20240225</title>
|
|
<link rel="stylesheet" href="../css/theme.css" />
|
|
<link rel="stylesheet" href="../css/theme_extra.css" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
|
|
|
|
<script>
|
|
// Current page data
|
|
var mkdocs_page_name = "Locations Pipelines Patch";
|
|
var mkdocs_page_input_path = "projects_locations-pipelines-patch.md";
|
|
var mkdocs_page_url = "/google-apis-rs/google-datapipelines1-cli/projects_locations-pipelines-patch/";
|
|
</script>
|
|
|
|
<script src="../js/jquery-3.6.0.min.js" defer></script>
|
|
<!--[if lt IE 9]>
|
|
<script src="../js/html5shiv.min.js"></script>
|
|
<![endif]-->
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
|
|
<script>hljs.initHighlightingOnLoad();</script>
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav" role="document">
|
|
|
|
<div class="wy-grid-for-nav">
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
|
|
<div class="wy-side-scroll">
|
|
<div class="wy-side-nav-search">
|
|
<a href=".." class="icon icon-home"> Datapipelines v5.0.4+20240225
|
|
</a><div role="search">
|
|
<form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
|
|
</form>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="..">Home</a>
|
|
</li>
|
|
</ul>
|
|
<p class="caption"><span class="caption-text">Projects</span></p>
|
|
<ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-create/">Locations Pipelines Create</a>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-delete/">Locations Pipelines Delete</a>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-get/">Locations Pipelines Get</a>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-jobs-list/">Locations Pipelines Jobs List</a>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-list/">Locations Pipelines List</a>
|
|
</li>
|
|
<li class="toctree-l1 current"><a class="reference internal current" href="./">Locations Pipelines Patch</a>
|
|
<ul class="current">
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-run/">Locations Pipelines Run</a>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../projects_locations-pipelines-stop/">Locations Pipelines Stop</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="..">Datapipelines v5.0.4+20240225</a>
|
|
|
|
</nav>
|
|
<div class="wy-nav-content">
|
|
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
|
|
<ul class="wy-breadcrumbs">
|
|
<li><a href=".." class="icon icon-home" alt="Docs"></a> »</li>
|
|
<li>Projects »</li>
|
|
<li>Locations Pipelines Patch</li>
|
|
<li class="wy-breadcrumbs-aside">
|
|
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/datapipelines1-cli/edit/master/docs/projects_locations-pipelines-patch.md"
|
|
class="icon icon-github"> Edit on GitHub</a>
|
|
</li>
|
|
</ul>
|
|
<hr/>
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div class="section" itemprop="articleBody">
|
|
|
|
<p>Updates a pipeline. If successful, the updated Pipeline is returned. Returns <code>NOT_FOUND</code> if the pipeline doesn't exist. If UpdatePipeline does not return successfully, you can retry the UpdatePipeline request until you receive a successful response.</p>
|
|
<h1 id="scopes">Scopes</h1>
|
|
<p>You will need authorization for the <em>https://www.googleapis.com/auth/cloud-platform</em> scope to make a valid call.</p>
|
|
<p>If unset, the scope for this method defaults to <em>https://www.googleapis.com/auth/cloud-platform</em>.
|
|
You can set the scope for this method like this: <code>datapipelines1 --scope <scope> projects locations-pipelines-patch ...</code></p>
|
|
<h1 id="required-scalar-argument">Required Scalar Argument</h1>
|
|
<ul>
|
|
<li><strong><name></strong> <em>(string)</em><ul>
|
|
<li>The pipeline name. For example: <code>projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID</code>. * <code>PROJECT_ID</code> can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), and periods (.). For more information, see <a href="https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects">Identifying projects</a>. * <code>LOCATION_ID</code> is the canonical ID for the pipeline's location. The list of available locations can be obtained by calling <code>google.cloud.location.Locations.ListLocations</code>. Note that the Data Pipelines service is not available in all regions. It depends on Cloud Scheduler, an App Engine application, so it's only available in <a href="https://cloud.google.com/about/locations#region">App Engine regions</a>. * <code>PIPELINE_ID</code> is the ID of the pipeline. Must be unique for the selected project and location.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="required-request-value">Required Request Value</h1>
|
|
<p>The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure.
|
|
In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely.</p>
|
|
<p>For example, a structure like this:</p>
|
|
<pre><code>GoogleCloudDatapipelinesV1Pipeline:
|
|
create-time: string
|
|
display-name: string
|
|
job-count: integer
|
|
last-update-time: string
|
|
name: string
|
|
pipeline-sources: { string: string }
|
|
schedule-info:
|
|
next-job-time: string
|
|
schedule: string
|
|
time-zone: string
|
|
scheduler-service-account-email: string
|
|
state: string
|
|
type: string
|
|
workload:
|
|
dataflow-flex-template-request:
|
|
launch-parameter:
|
|
container-spec-gcs-path: string
|
|
environment:
|
|
additional-experiments: [string]
|
|
additional-user-labels: { string: string }
|
|
enable-streaming-engine: boolean
|
|
flexrs-goal: string
|
|
ip-configuration: string
|
|
kms-key-name: string
|
|
machine-type: string
|
|
max-workers: integer
|
|
network: string
|
|
num-workers: integer
|
|
service-account-email: string
|
|
subnetwork: string
|
|
temp-location: string
|
|
worker-region: string
|
|
worker-zone: string
|
|
zone: string
|
|
job-name: string
|
|
launch-options: { string: string }
|
|
parameters: { string: string }
|
|
transform-name-mappings: { string: string }
|
|
update: boolean
|
|
location: string
|
|
project-id: string
|
|
validate-only: boolean
|
|
dataflow-launch-template-request:
|
|
gcs-path: string
|
|
launch-parameters:
|
|
environment:
|
|
additional-experiments: [string]
|
|
additional-user-labels: { string: string }
|
|
bypass-temp-dir-validation: boolean
|
|
enable-streaming-engine: boolean
|
|
ip-configuration: string
|
|
kms-key-name: string
|
|
machine-type: string
|
|
max-workers: integer
|
|
network: string
|
|
num-workers: integer
|
|
service-account-email: string
|
|
subnetwork: string
|
|
temp-location: string
|
|
worker-region: string
|
|
worker-zone: string
|
|
zone: string
|
|
job-name: string
|
|
parameters: { string: string }
|
|
transform-name-mapping: { string: string }
|
|
update: boolean
|
|
location: string
|
|
project-id: string
|
|
validate-only: boolean
|
|
|
|
</code></pre>
|
|
<p>can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time.</p>
|
|
<ul>
|
|
<li><code>-r . create-time=vero</code><ul>
|
|
<li>Output only. Immutable. The timestamp when the pipeline was initially created. Set by the Data Pipelines service.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>display-name=invidunt</code><ul>
|
|
<li>Required. The display name of the pipeline. It can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), and underscores (_).</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>job-count=36</code><ul>
|
|
<li>Output only. Number of jobs.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>last-update-time=vero</code><ul>
|
|
<li>Output only. Immutable. The timestamp when the pipeline was last modified. Set by the Data Pipelines service.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>name=elitr</code><ul>
|
|
<li>The pipeline name. For example: <code>projects/PROJECT_ID/locations/LOCATION_ID/pipelines/PIPELINE_ID</code>. * <code>PROJECT_ID</code> can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), and periods (.). For more information, see <a href="https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects">Identifying projects</a>. * <code>LOCATION_ID</code> is the canonical ID for the pipeline's location. The list of available locations can be obtained by calling <code>google.cloud.location.Locations.ListLocations</code>. Note that the Data Pipelines service is not available in all regions. It depends on Cloud Scheduler, an App Engine application, so it's only available in <a href="https://cloud.google.com/about/locations#region">App Engine regions</a>. * <code>PIPELINE_ID</code> is the ID of the pipeline. Must be unique for the selected project and location.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>pipeline-sources=key=lorem</code><ul>
|
|
<li>Immutable. The sources of the pipeline (for example, Dataplex). The keys and values are set by the corresponding sources during pipeline creation.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>schedule-info next-job-time=diam</code><ul>
|
|
<li>Output only. When the next Scheduler job is going to run.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>schedule=no</code><ul>
|
|
<li>Unix-cron format of the schedule. This information is retrieved from the linked Cloud Scheduler.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>time-zone=ipsum</code></p>
|
|
<ul>
|
|
<li>Timezone ID. This matches the timezone IDs used by the Cloud Scheduler API. If empty, UTC time is assumed.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. scheduler-service-account-email=accusam</code></p>
|
|
<ul>
|
|
<li>Optional. A service account email to be used with the Cloud Scheduler job. If not specified, the default compute engine service account will be used.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>state=takimata</code><ul>
|
|
<li>Required. The state of the pipeline. When the pipeline is created, the state is set to 'PIPELINE_STATE_ACTIVE' by default. State changes can be requested by setting the state to stopping, paused, or resuming. State cannot be changed through UpdatePipeline requests.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>type=consetetur</code><ul>
|
|
<li>Required. The type of the pipeline. This field affects the scheduling of the pipeline and the type of metrics to show for the pipeline.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>workload.dataflow-flex-template-request.launch-parameter container-spec-gcs-path=voluptua.</code><ul>
|
|
<li>Cloud Storage path to a file with a JSON-serialized ContainerSpec as content.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>environment additional-experiments=et</code><ul>
|
|
<li>Additional experiment flags for the job.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>additional-user-labels=key=erat</code><ul>
|
|
<li>Additional user labels to be specified for the job. Keys and values must follow the restrictions specified in the <a href="https://cloud.google.com/compute/docs/labeling-resources#restrictions">labeling restrictions</a>. An object containing a list of key/value pairs. Example: <code>{ &#34;name&#34;: &#34;wrench&#34;, &#34;mass&#34;: &#34;1kg&#34;, &#34;count&#34;: &#34;3&#34; }</code>.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>enable-streaming-engine=false</code><ul>
|
|
<li>Whether to enable Streaming Engine for the job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>flexrs-goal=amet.</code><ul>
|
|
<li>Set FlexRS goal for the job. https://cloud.google.com/dataflow/docs/guides/flexrs</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>ip-configuration=sed</code><ul>
|
|
<li>Configuration for VM IPs.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>kms-key-name=takimata</code><ul>
|
|
<li>Name for the Cloud KMS key for the job. Key format is: projects//locations//keyRings//cryptoKeys/</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>machine-type=dolores</code><ul>
|
|
<li>The machine type to use for the job. Defaults to the value from the template if not specified.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>max-workers=39</code><ul>
|
|
<li>The maximum number of Compute Engine instances to be made available to your pipeline during execution, from 1 to 1000.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>network=et</code><ul>
|
|
<li>Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>num-workers=78</code><ul>
|
|
<li>The initial number of Compute Engine instances for the job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>service-account-email=voluptua.</code><ul>
|
|
<li>The email address of the service account to run the job as.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>subnetwork=dolore</code><ul>
|
|
<li>Subnetwork to which VMs will be assigned, if desired. You can specify a subnetwork using either a complete URL or an abbreviated path. Expected to be of the form "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>temp-location=dolore</code><ul>
|
|
<li>The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with <code>gs://</code>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>worker-region=dolore</code><ul>
|
|
<li>The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, defaults to the control plane region.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>worker-zone=voluptua.</code><ul>
|
|
<li>The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1-a". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane region is chosen based on available capacity. If both <code>worker_zone</code> and <code>zone</code> are set, <code>worker_zone</code> takes precedence.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>zone=amet.</code></p>
|
|
<ul>
|
|
<li>The Compute Engine <a href="https://cloud.google.com/compute/docs/regions-zones/regions-zones">availability zone</a> for launching worker instances to run your pipeline. In the future, worker_zone will take precedence.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. job-name=ea</code></p>
|
|
<ul>
|
|
<li>Required. The job name to use for the created job. For an update job request, the job name should be the same as the existing running job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>launch-options=key=sadipscing</code><ul>
|
|
<li>Launch options for this Flex Template job. This is a common set of options across languages and templates. This should not be used to pass job parameters.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>parameters=key=lorem</code><ul>
|
|
<li>The parameters for the Flex Template. Example: <code>{&#34;num_workers&#34;:&#34;5&#34;}</code></li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>transform-name-mappings=key=invidunt</code><ul>
|
|
<li>Use this to pass transform name mappings for streaming update jobs. Example: <code>{&#34;oldTransformName&#34;:&#34;newTransformName&#34;,...}</code></li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>update=true</code></p>
|
|
<ul>
|
|
<li>Set this to true if you are sending a request to update a running streaming job. When set, the job name should be the same as the running job.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. location=sit</code></p>
|
|
<ul>
|
|
<li>Required. The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to which to direct the request. For example, <code>us-central1</code>, <code>us-west1</code>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>project-id=et</code><ul>
|
|
<li>Required. The ID of the Cloud Platform project that the job belongs to.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>validate-only=true</code></p>
|
|
<ul>
|
|
<li>If true, the request is validated but not actually executed. Defaults to false.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>..dataflow-launch-template-request gcs-path=aliquyam</code></p>
|
|
<ul>
|
|
<li>A Cloud Storage path to the template from which to create the job. Must be a valid Cloud Storage URL, beginning with 'gs://'.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>launch-parameters.environment additional-experiments=ipsum</code><ul>
|
|
<li>Additional experiment flags for the job.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>additional-user-labels=key=et</code><ul>
|
|
<li>Additional user labels to be specified for the job. Keys and values should follow the restrictions specified in the <a href="https://cloud.google.com/compute/docs/labeling-resources#restrictions">labeling restrictions</a> page. An object containing a list of key/value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" }.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>bypass-temp-dir-validation=true</code><ul>
|
|
<li>Whether to bypass the safety checks for the job's temporary directory. Use with caution.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>enable-streaming-engine=true</code><ul>
|
|
<li>Whether to enable Streaming Engine for the job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>ip-configuration=et</code><ul>
|
|
<li>Configuration for VM IPs.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>kms-key-name=sed</code><ul>
|
|
<li>Name for the Cloud KMS key for the job. The key format is: projects//locations//keyRings//cryptoKeys/</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>machine-type=no</code><ul>
|
|
<li>The machine type to use for the job. Defaults to the value from the template if not specified.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>max-workers=16</code><ul>
|
|
<li>The maximum number of Compute Engine instances to be made available to your pipeline during execution, from 1 to 1000.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>network=elitr</code><ul>
|
|
<li>Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>num-workers=21</code><ul>
|
|
<li>The initial number of Compute Engine instances for the job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>service-account-email=no</code><ul>
|
|
<li>The email address of the service account to run the job as.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>subnetwork=nonumy</code><ul>
|
|
<li>Subnetwork to which VMs will be assigned, if desired. You can specify a subnetwork using either a complete URL or an abbreviated path. Expected to be of the form "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK" or "regions/REGION/subnetworks/SUBNETWORK". If the subnetwork is located in a Shared VPC network, you must use the complete URL.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>temp-location=at</code><ul>
|
|
<li>The Cloud Storage path to use for temporary files. Must be a valid Cloud Storage URL, beginning with <code>gs://</code>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>worker-region=sadipscing</code><ul>
|
|
<li>The Compute Engine region (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1". Mutually exclusive with worker_zone. If neither worker_region nor worker_zone is specified, default to the control plane's region.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>worker-zone=aliquyam</code><ul>
|
|
<li>The Compute Engine zone (https://cloud.google.com/compute/docs/regions-zones/regions-zones) in which worker processing should occur, e.g. "us-west1-a". Mutually exclusive with worker_region. If neither worker_region nor worker_zone is specified, a zone in the control plane's region is chosen based on available capacity. If both <code>worker_zone</code> and <code>zone</code> are set, <code>worker_zone</code> takes precedence.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>zone=dolores</code></p>
|
|
<ul>
|
|
<li>The Compute Engine <a href="https://cloud.google.com/compute/docs/regions-zones/regions-zones">availability zone</a> for launching worker instances to run your pipeline. In the future, worker_zone will take precedence.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. job-name=sadipscing</code></p>
|
|
<ul>
|
|
<li>Required. The job name to use for the created job.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>parameters=key=erat</code><ul>
|
|
<li>The runtime parameters to pass to the job.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li><code>transform-name-mapping=key=aliquyam</code><ul>
|
|
<li>Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job. Only applicable when updating a pipeline.</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>update=true</code></p>
|
|
<ul>
|
|
<li>If set, replace the existing pipeline with the name specified by jobName with this pipeline, preserving state.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. location=est</code></p>
|
|
<ul>
|
|
<li>The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to which to direct the request.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>project-id=et</code><ul>
|
|
<li>Required. The ID of the Cloud Platform project that the job belongs to.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>validate-only=false</code><ul>
|
|
<li>If true, the request is validated but not actually executed. Defaults to false.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h3 id="about-cursors">About Cursors</h3>
|
|
<p>The cursor position is key to comfortably set complex nested structures. The following rules apply:</p>
|
|
<ul>
|
|
<li>The cursor position is always set relative to the current one, unless the field name starts with the <code>.</code> character. Fields can be nested such as in <code>-r f.s.o</code> .</li>
|
|
<li>The cursor position is set relative to the top-level structure if it starts with <code>.</code>, e.g. <code>-r .s.s</code></li>
|
|
<li>You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify <code>-r struct.sub_struct=bar</code>.</li>
|
|
<li>You can move the cursor one level up by using <code>..</code>. Each additional <code>.</code> moves it up one additional level. E.g. <code>...</code> would go three levels up.</li>
|
|
</ul>
|
|
<h1 id="optional-output-flags">Optional Output Flags</h1>
|
|
<p>The method's return value a JSON encoded structure, which will be written to standard output by default.</p>
|
|
<ul>
|
|
<li><strong>-o out</strong><ul>
|
|
<li><em>out</em> specifies the <em>destination</em> to which to write the server's result to.
|
|
It will be a JSON-encoded structure.
|
|
The <em>destination</em> may be <code>-</code> to indicate standard output, or a filepath that is to contain the received bytes.
|
|
If unset, it defaults to standard output.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="optional-method-properties">Optional Method Properties</h1>
|
|
<p>You may set the following properties to further configure the call. Please note that <code>-p</code> is followed by one
|
|
or more key-value-pairs, and is called like this <code>-p k1=v1 k2=v2</code> even though the listing below repeats the
|
|
<code>-p</code> for completeness.</p>
|
|
<ul>
|
|
<li><strong>-p update-mask=string</strong><ul>
|
|
<li>The list of fields to be updated.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="optional-general-properties">Optional General Properties</h1>
|
|
<p>The following properties can configure any call, and are not specific to this method.</p>
|
|
<ul>
|
|
<li>
|
|
<p><strong>-p $-xgafv=string</strong></p>
|
|
<ul>
|
|
<li>V1 error format.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p access-token=string</strong></p>
|
|
<ul>
|
|
<li>OAuth access token.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p alt=string</strong></p>
|
|
<ul>
|
|
<li>Data format for response.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p callback=string</strong></p>
|
|
<ul>
|
|
<li>JSONP</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p fields=string</strong></p>
|
|
<ul>
|
|
<li>Selector specifying which fields to include in a partial response.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p key=string</strong></p>
|
|
<ul>
|
|
<li>API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p oauth-token=string</strong></p>
|
|
<ul>
|
|
<li>OAuth 2.0 token for the current user.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p pretty-print=boolean</strong></p>
|
|
<ul>
|
|
<li>Returns response with indentations and line breaks.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p quota-user=string</strong></p>
|
|
<ul>
|
|
<li>Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p upload-type=string</strong></p>
|
|
<ul>
|
|
<li>Legacy upload protocol for media (e.g. "media", "multipart").</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p upload-protocol=string</strong></p>
|
|
<ul>
|
|
<li>Upload protocol for media (e.g. "raw", "multipart").</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div><footer>
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
|
|
<a href="../projects_locations-pipelines-list/" class="btn btn-neutral float-left" title="Locations Pipelines List"><span class="icon icon-circle-arrow-left"></span> Previous</a>
|
|
<a href="../projects_locations-pipelines-run/" class="btn btn-neutral float-right" title="Locations Pipelines Run">Next <span class="icon icon-circle-arrow-right"></span></a>
|
|
</div>
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<!-- Copyright etc -->
|
|
<p>Copyright © 2015-2020, `Sebastian Thiel`</p>
|
|
</div>
|
|
|
|
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
</footer>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
<div class="rst-versions" role="note" aria-label="Versions">
|
|
<span class="rst-current-version" data-toggle="rst-current-version">
|
|
|
|
<span>
|
|
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/datapipelines1-cli" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
|
|
</span>
|
|
|
|
|
|
<span><a href="../projects_locations-pipelines-list/" style="color: #fcfcfc">« Previous</a></span>
|
|
|
|
|
|
<span><a href="../projects_locations-pipelines-run/" style="color: #fcfcfc">Next »</a></span>
|
|
|
|
</span>
|
|
</div>
|
|
<script>var base_url = '..';</script>
|
|
<script src="../js/theme_extra.js" defer></script>
|
|
<script src="../js/theme.js" defer></script>
|
|
<script src="../search/main.js" defer></script>
|
|
<script defer>
|
|
window.onload = function () {
|
|
SphinxRtdTheme.Navigation.enable(true);
|
|
};
|
|
</script>
|
|
|
|
</body>
|
|
</html>
|