Updates a WorkerPool
.
Scopes
You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call.
If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform.
You can set the scope for this method like this: cloudbuild1 --scope <scope> projects locations-worker-pools-patch ...
Required Scalar Argument
- <name> (string)
- Output only. The resource name of the
WorkerPool
, with formatprojects/{project}/locations/{location}/workerPools/{worker_pool}
. The value of{worker_pool}
is provided byworker_pool_id
inCreateWorkerPool
request and the value of{location}
is determined by the endpoint accessed.
- Output only. The resource name of the
Required Request Value
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.
For example, a structure like this:
WorkerPool:
annotations: { string: string }
create-time: string
delete-time: string
display-name: string
etag: string
name: string
private-pool-v1-config:
network-config:
egress-option: string
peered-network: string
peered-network-ip-range: string
private-service-connect:
network-attachment: string
public-ip-address-disabled: boolean
route-all-traffic: boolean
worker-config:
disk-size-gb: string
machine-type: string
state: string
uid: string
update-time: string
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.
-r . annotations=key=invidunt
- User specified annotations. See https://google.aip.dev/128#annotations for more details such as format and size limitations.
- the value will be associated with the given
key
create-time=accusam
- Output only. Time at which the request to create the
WorkerPool
was received.
- Output only. Time at which the request to create the
delete-time=amet.
- Output only. Time at which the request to delete the
WorkerPool
was received.
- Output only. Time at which the request to delete the
display-name=sanctus
- A user-specified, human-readable name for the
WorkerPool
. If provided, this value must be 1-63 characters.
- A user-specified, human-readable name for the
etag=invidunt
- Output only. Checksum computed by the server. May be sent on update and delete requests to ensure that the client has an up-to-date value before proceeding.
name=sit
- Output only. The resource name of the
WorkerPool
, with formatprojects/{project}/locations/{location}/workerPools/{worker_pool}
. The value of{worker_pool}
is provided byworker_pool_id
inCreateWorkerPool
request and the value of{location}
is determined by the endpoint accessed.
- Output only. The resource name of the
private-pool-v1-config.network-config egress-option=sed
- Option to configure network egress for the workers.
peered-network=duo
- Required. Immutable. The network definition that the workers are peered to. If this section is left empty, the workers will be peered to
WorkerPool.project_id
on the service producer network. Must be in the formatprojects/{project}/global/networks/{network}
, where{project}
is a project number, such as12345
, and{network}
is the name of a VPC network in the project. See Understanding network configuration options
- Required. Immutable. The network definition that the workers are peered to. If this section is left empty, the workers will be peered to
-
peered-network-ip-range=et
- Immutable. Subnet IP range within the peered network. This is specified in CIDR notation with a slash and the subnet prefix size. You can optionally specify an IP address before the subnet prefix value. e.g.
192.168.0.0/29
would specify an IP range starting at 192.168.0.0 with a prefix size of 29 bits./16
would specify a prefix size of 16 bits, with an automatically determined IP within the peered VPC. If unspecified, a value of/24
will be used.
- Immutable. Subnet IP range within the peered network. This is specified in CIDR notation with a slash and the subnet prefix size. You can optionally specify an IP address before the subnet prefix value. e.g.
-
..private-service-connect network-attachment=dolor
- Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format
projects/{project}/regions/{region}/networkAttachments/{networkAttachment}
. The region of network attachment must be the same as the worker pool. See Network Attachments
- Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format
public-ip-address-disabled=true
- Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If
route_all_traffic
is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.
- Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If
-
route-all-traffic=false
- Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.
-
..worker-config disk-size-gb=justo
- Size of the disk attached to the worker, in GB. See Worker pool config file. Specify a value of up to 2000. If
0
is specified, Cloud Build will use a standard disk size.
- Size of the disk attached to the worker, in GB. See Worker pool config file. Specify a value of up to 2000. If
-
machine-type=sadipscing
- Machine type of a worker, such as
e2-medium
. See Worker pool config file. If left blank, Cloud Build will use a sensible default.
- Machine type of a worker, such as
-
... state=accusam
- Output only.
WorkerPool
state.
- Output only.
uid=takimata
- Output only. A unique identifier for the
WorkerPool
.
- Output only. A unique identifier for the
update-time=invidunt
- Output only. Time at which the request to update the
WorkerPool
was received.
- Output only. Time at which the request to update the
About Cursors
The cursor position is key to comfortably set complex nested structures. The following rules apply:
- The cursor position is always set relative to the current one, unless the field name starts with the
.
character. Fields can be nested such as in-r f.s.o
. - The cursor position is set relative to the top-level structure if it starts with
.
, e.g.-r .s.s
- 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
-r struct.sub_struct=bar
. - You can move the cursor one level up by using
..
. Each additional.
moves it up one additional level. E.g....
would go three levels up.
Optional Output Flags
The method's return value a JSON encoded structure, which will be written to standard output by default.
- -o out
- out specifies the destination to which to write the server's result to.
It will be a JSON-encoded structure.
The destination may be
-
to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.
- out specifies the destination to which to write the server's result to.
It will be a JSON-encoded structure.
The destination may be
Optional Method Properties
You may set the following properties to further configure the call. Please note that -p
is followed by one
or more key-value-pairs, and is called like this -p k1=v1 k2=v2
even though the listing below repeats the
-p
for completeness.
-
-p update-mask=string
- A mask specifying which fields in
worker_pool
to update.
- A mask specifying which fields in
-
-p validate-only=boolean
- If set, validate the request and preview the response, but do not actually post it.
Optional General Properties
The following properties can configure any call, and are not specific to this method.
-
-p $-xgafv=string
- V1 error format.
-
-p access-token=string
- OAuth access token.
-
-p alt=string
- Data format for response.
-
-p callback=string
- JSONP
-
-p fields=string
- Selector specifying which fields to include in a partial response.
-
-p key=string
- 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.
-
-p oauth-token=string
- OAuth 2.0 token for the current user.
-
-p pretty-print=boolean
- Returns response with indentations and line breaks.
-
-p quota-user=string
- 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.
-
-p upload-type=string
- Legacy upload protocol for media (e.g. "media", "multipart").
-
-p upload-protocol=string
- Upload protocol for media (e.g. "raw", "multipart").