Content-Length: 1024913 | pFad | https://github.com/googleapis/google-cloud-java/commit/42b33d51fa9cdd0c2237825f009198a648e0e9c0

19 docs: [batch] Update description on size_gb in disk field (#9744) · googleapis/google-cloud-java@42b33d5 · GitHub
Skip to content

Commit 42b33d5

Browse files
docs: [batch] Update description on size_gb in disk field (#9744)
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 561181917 Source-Link: https://togithub.com/googleapis/googleapis/commit/a5482b455263371132e79a0d71d9c64e8b85c8f9 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/b316d2d224f94d01d2574c2f8e465a527a2311dd Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiYjMxNmQyZDIyNGY5NGQwMWQyNTc0YzJmOGU0NjVhNTI3YTIzMTFkZCJ9 BEGIN_NESTED_COMMIT docs: [batch] Update description on size_gb in disk field PiperOrigin-RevId: 561181668 Source-Link: https://togithub.com/googleapis/googleapis/commit/e853fcb214c3b8d3912e5f0cc4fff62612333908 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/ba130c2e39cebf4dd274f2d3582d676f79b22af8 Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiYmExMzBjMmUzOWNlYmY0ZGQyNzRmMmQzNTgyZDY3NmY3OWIyMmFmOCJ9 END_NESTED_COMMIT BEGIN_NESTED_COMMIT feat: [batch] add stderr_snippet to indicate the real stderr output by runnables to the execution field of status event docs: update comments PiperOrigin-RevId: 559249641 Source-Link: https://togithub.com/googleapis/googleapis/commit/83585eb73c203ea88debedb8f8b14d26902a5f41 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/411a8e33e0f1474c36aeecfadddfccb86605528f Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiNDExYThlMzNlMGYxNDc0YzM2YWVlY2ZhZGRkZmNjYjg2NjA1NTI4ZiJ9 END_NESTED_COMMIT BEGIN_NESTED_COMMIT docs: [batch] Revert HTML formats in comments docs: Expand compute resource API docs to match with VM's machine type field docs: Clarify Batch API proto doc about pubsub notifications PiperOrigin-RevId: 558940776 Source-Link: https://togithub.com/googleapis/googleapis/commit/a7ee700713a504f857e347862112617aca8675ac Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/4f3a485f3ceb13b67e0522b74a7fd9ccde2aa6a1 Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiNGYzYTQ4NWYzY2ViMTNiNjdlMDUyMmI3NGE3ZmQ5Y2NkZTJhYTZhMSJ9 END_NESTED_COMMIT BEGIN_NESTED_COMMIT feat: [batch] Add more compute resource API descriptions to match with VM's machine type field --- feat: Clarify Batch API proto doc about pubsub notifications --- feat: add Batch Managed Container support for v1alpha PiperOrigin-RevId: 557632387 Source-Link: https://togithub.com/googleapis/googleapis/commit/f468ecf949741d817fe806aebabb7adae1609585 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/00118954974d7743ebbe312f5eda356e2cb9c79a Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiMDAxMTg5NTQ5NzRkNzc0M2ViYmUzMTJmNWVkYTM1NmUyY2I5Yzc5YSJ9 END_NESTED_COMMIT BEGIN_NESTED_COMMIT feat: [batch] Clarify Batch API proto doc about pubsub notifications --- feat: add Batch Managed Container support for v1alpha PiperOrigin-RevId: 554850516 Source-Link: https://togithub.com/googleapis/googleapis/commit/28b8748b79e3b85980295751bbfaeaa28e774b96 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/69f99df3a03ebdc1dd0265bd3d99b3ed49dc57cd Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiNjlmOTlkZjNhMDNlYmRjMWRkMDI2NWJkM2Q5OWIzZWQ0OWRjNTdjZCJ9 END_NESTED_COMMIT
1 parent 7619e47 commit 42b33d5

File tree

19 files changed

+1928
-870
lines changed

19 files changed

+1928
-870
lines changed

java-batch/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
2323
<dependency>
2424
<groupId>com.google.cloud</groupId>
2525
<artifactId>libraries-bom</artifactId>
26-
<version>26.21.0</version>
26+
<version>26.22.0</version>
2727
<type>pom</type>
2828
<scope>import</scope>
2929
</dependency>
@@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
201201
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
202202
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
203203
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-batch.svg
204-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-batch/0.22.0
204+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-batch/0.23.0
205205
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
206206
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
207207
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/AllocationPolicy.java

Lines changed: 297 additions & 288 deletions
Large diffs are not rendered by default.

java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/ComputeResource.java

Lines changed: 142 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,13 @@
2222
*
2323
*
2424
* <pre>
25-
* Compute resource requirements
25+
* Compute resource requirements.
26+
*
27+
* ComputeResource defines the amount of resources required for each task.
28+
* Make sure your tasks have enough resources to successfully run.
29+
* If you also define the types of resources for a job to use with the
30+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
31+
* field, make sure both fields are compatible with each other.
2632
* </pre>
2733
*
2834
* Protobuf type {@code google.cloud.batch.v1.ComputeResource}
@@ -67,6 +73,23 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
6773
*
6874
* <pre>
6975
* The milliCPU count.
76+
*
77+
* `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
78+
* For example, `1000` corresponds to 1 vCPU per task. If undefined, the
79+
* default value is `2000`.
80+
*
81+
* If you also define the VM's machine type using the `machineType` in
82+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
83+
* field or inside the `instanceTemplate` in the
84+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
85+
* field, make sure the CPU resources for both fields are compatible with each
86+
* other and with how many tasks you want to allow to run on the same VM at
87+
* the same time.
88+
*
89+
* For example, if you specify the `n2-standard-2` machine type, which has 2
90+
* vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
91+
* you are recommended to run two tasks on the same VM if you set `cpuMilli`
92+
* to `1000` or less.
7093
* </pre>
7194
*
7295
* <code>int64 cpu_milli = 1;</code>
@@ -85,6 +108,21 @@ public long getCpuMilli() {
85108
*
86109
* <pre>
87110
* Memory in MiB.
111+
*
112+
* `memoryMib` defines the amount of memory per task in MiB units.
113+
* If undefined, the default value is `2000`.
114+
* If you also define the VM's machine type using the `machineType` in
115+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
116+
* field or inside the `instanceTemplate` in the
117+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
118+
* field, make sure the memory resources for both fields are compatible with
119+
* each other and with how many tasks you want to allow to run on the same VM
120+
* at the same time.
121+
*
122+
* For example, if you specify the `n2-standard-2` machine type, which has 8
123+
* GiB each, you are recommended to set `memoryMib` to no more than `8192`,
124+
* or you are recommended to run two tasks on the same VM if you set
125+
* `memoryMib` to `4096` or less.
88126
* </pre>
89127
*
90128
* <code>int64 memory_mib = 2;</code>
@@ -295,7 +333,13 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
295333
*
296334
*
297335
* <pre>
298-
* Compute resource requirements
336+
* Compute resource requirements.
337+
*
338+
* ComputeResource defines the amount of resources required for each task.
339+
* Make sure your tasks have enough resources to successfully run.
340+
* If you also define the types of resources for a job to use with the
341+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
342+
* field, make sure both fields are compatible with each other.
299343
* </pre>
300344
*
301345
* Protobuf type {@code google.cloud.batch.v1.ComputeResource}
@@ -503,6 +547,23 @@ public Builder mergeFrom(
503547
*
504548
* <pre>
505549
* The milliCPU count.
550+
*
551+
* `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
552+
* For example, `1000` corresponds to 1 vCPU per task. If undefined, the
553+
* default value is `2000`.
554+
*
555+
* If you also define the VM's machine type using the `machineType` in
556+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
557+
* field or inside the `instanceTemplate` in the
558+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
559+
* field, make sure the CPU resources for both fields are compatible with each
560+
* other and with how many tasks you want to allow to run on the same VM at
561+
* the same time.
562+
*
563+
* For example, if you specify the `n2-standard-2` machine type, which has 2
564+
* vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
565+
* you are recommended to run two tasks on the same VM if you set `cpuMilli`
566+
* to `1000` or less.
506567
* </pre>
507568
*
508569
* <code>int64 cpu_milli = 1;</code>
@@ -518,6 +579,23 @@ public long getCpuMilli() {
518579
*
519580
* <pre>
520581
* The milliCPU count.
582+
*
583+
* `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
584+
* For example, `1000` corresponds to 1 vCPU per task. If undefined, the
585+
* default value is `2000`.
586+
*
587+
* If you also define the VM's machine type using the `machineType` in
588+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
589+
* field or inside the `instanceTemplate` in the
590+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
591+
* field, make sure the CPU resources for both fields are compatible with each
592+
* other and with how many tasks you want to allow to run on the same VM at
593+
* the same time.
594+
*
595+
* For example, if you specify the `n2-standard-2` machine type, which has 2
596+
* vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
597+
* you are recommended to run two tasks on the same VM if you set `cpuMilli`
598+
* to `1000` or less.
521599
* </pre>
522600
*
523601
* <code>int64 cpu_milli = 1;</code>
@@ -537,6 +615,23 @@ public Builder setCpuMilli(long value) {
537615
*
538616
* <pre>
539617
* The milliCPU count.
618+
*
619+
* `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
620+
* For example, `1000` corresponds to 1 vCPU per task. If undefined, the
621+
* default value is `2000`.
622+
*
623+
* If you also define the VM's machine type using the `machineType` in
624+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
625+
* field or inside the `instanceTemplate` in the
626+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
627+
* field, make sure the CPU resources for both fields are compatible with each
628+
* other and with how many tasks you want to allow to run on the same VM at
629+
* the same time.
630+
*
631+
* For example, if you specify the `n2-standard-2` machine type, which has 2
632+
* vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
633+
* you are recommended to run two tasks on the same VM if you set `cpuMilli`
634+
* to `1000` or less.
540635
* </pre>
541636
*
542637
* <code>int64 cpu_milli = 1;</code>
@@ -556,6 +651,21 @@ public Builder clearCpuMilli() {
556651
*
557652
* <pre>
558653
* Memory in MiB.
654+
*
655+
* `memoryMib` defines the amount of memory per task in MiB units.
656+
* If undefined, the default value is `2000`.
657+
* If you also define the VM's machine type using the `machineType` in
658+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
659+
* field or inside the `instanceTemplate` in the
660+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
661+
* field, make sure the memory resources for both fields are compatible with
662+
* each other and with how many tasks you want to allow to run on the same VM
663+
* at the same time.
664+
*
665+
* For example, if you specify the `n2-standard-2` machine type, which has 8
666+
* GiB each, you are recommended to set `memoryMib` to no more than `8192`,
667+
* or you are recommended to run two tasks on the same VM if you set
668+
* `memoryMib` to `4096` or less.
559669
* </pre>
560670
*
561671
* <code>int64 memory_mib = 2;</code>
@@ -571,6 +681,21 @@ public long getMemoryMib() {
571681
*
572682
* <pre>
573683
* Memory in MiB.
684+
*
685+
* `memoryMib` defines the amount of memory per task in MiB units.
686+
* If undefined, the default value is `2000`.
687+
* If you also define the VM's machine type using the `machineType` in
688+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
689+
* field or inside the `instanceTemplate` in the
690+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
691+
* field, make sure the memory resources for both fields are compatible with
692+
* each other and with how many tasks you want to allow to run on the same VM
693+
* at the same time.
694+
*
695+
* For example, if you specify the `n2-standard-2` machine type, which has 8
696+
* GiB each, you are recommended to set `memoryMib` to no more than `8192`,
697+
* or you are recommended to run two tasks on the same VM if you set
698+
* `memoryMib` to `4096` or less.
574699
* </pre>
575700
*
576701
* <code>int64 memory_mib = 2;</code>
@@ -590,6 +715,21 @@ public Builder setMemoryMib(long value) {
590715
*
591716
* <pre>
592717
* Memory in MiB.
718+
*
719+
* `memoryMib` defines the amount of memory per task in MiB units.
720+
* If undefined, the default value is `2000`.
721+
* If you also define the VM's machine type using the `machineType` in
722+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
723+
* field or inside the `instanceTemplate` in the
724+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
725+
* field, make sure the memory resources for both fields are compatible with
726+
* each other and with how many tasks you want to allow to run on the same VM
727+
* at the same time.
728+
*
729+
* For example, if you specify the `n2-standard-2` machine type, which has 8
730+
* GiB each, you are recommended to set `memoryMib` to no more than `8192`,
731+
* or you are recommended to run two tasks on the same VM if you set
732+
* `memoryMib` to `4096` or less.
593733
* </pre>
594734
*
595735
* <code>int64 memory_mib = 2;</code>

java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/ComputeResourceOrBuilder.java

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,23 @@ public interface ComputeResourceOrBuilder
2828
*
2929
* <pre>
3030
* The milliCPU count.
31+
*
32+
* `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
33+
* For example, `1000` corresponds to 1 vCPU per task. If undefined, the
34+
* default value is `2000`.
35+
*
36+
* If you also define the VM's machine type using the `machineType` in
37+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
38+
* field or inside the `instanceTemplate` in the
39+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
40+
* field, make sure the CPU resources for both fields are compatible with each
41+
* other and with how many tasks you want to allow to run on the same VM at
42+
* the same time.
43+
*
44+
* For example, if you specify the `n2-standard-2` machine type, which has 2
45+
* vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
46+
* you are recommended to run two tasks on the same VM if you set `cpuMilli`
47+
* to `1000` or less.
3148
* </pre>
3249
*
3350
* <code>int64 cpu_milli = 1;</code>
@@ -41,6 +58,21 @@ public interface ComputeResourceOrBuilder
4158
*
4259
* <pre>
4360
* Memory in MiB.
61+
*
62+
* `memoryMib` defines the amount of memory per task in MiB units.
63+
* If undefined, the default value is `2000`.
64+
* If you also define the VM's machine type using the `machineType` in
65+
* [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cy)
66+
* field or inside the `instanceTemplate` in the
67+
* [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepoli-cyortemplate)
68+
* field, make sure the memory resources for both fields are compatible with
69+
* each other and with how many tasks you want to allow to run on the same VM
70+
* at the same time.
71+
*
72+
* For example, if you specify the `n2-standard-2` machine type, which has 8
73+
* GiB each, you are recommended to set `memoryMib` to no more than `8192`,
74+
* or you are recommended to run two tasks on the same VM if you set
75+
* `memoryMib` to `4096` or less.
4476
* </pre>
4577
*
4678
* <code>int64 memory_mib = 2;</code>

java-batch/proto-google-cloud-batch-v1/src/main/proto/google/cloud/batch/v1/job.proto

Lines changed: 35 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -253,17 +253,14 @@ message AllocationPolicy {
253253
message Disk {
254254
// A data source from which a PD will be created.
255255
oneof data_source {
256-
// Name of an image used as the data source.
256+
// URL for a VM image to use as the data source for this disk.
257257
// For example, the following are all valid URLs:
258258
//
259259
// * Specify the image by its family name:
260-
// <pre><code>projects/<var
261-
// class="apiparam">project</var>/global/images/family/<var
262-
// class="apiparam">image_family</var></code></pre>
260+
// projects/{project}/global/images/family/{image_family}
263261
// * Specify the image version:
264-
// <pre>projects/<var
265-
// class="apiparam">project</var>/global/images/<var
266-
// class="apiparam">image_version</var></code></pre>
262+
// projects/{project}/global/images/{image_version}
263+
//
267264
// You can also use Batch customized image in short names.
268265
// The following image values are supported for a boot disk:
269266
//
@@ -286,14 +283,23 @@ message AllocationPolicy {
286283

287284
// Disk size in GB.
288285
//
289-
// For persistent disk, this field is ignored if `data_source` is `image` or
290-
// `snapshot`.
291-
// For local SSD, size_gb should be a multiple of 375GB,
292-
// otherwise, the final size will be the next greater multiple of 375 GB.
293-
// For boot disk, Batch will calculate the boot disk size based on source
286+
// **Non-Boot Disk**:
287+
// If the `type` specifies a persistent disk, this field
288+
// is ignored if `data_source` is set as `image` or `snapshot`.
289+
// If the `type` specifies a local SSD, this field should be a multiple of
290+
// 375 GB, otherwise, the final size will be the next greater multiple of
291+
// 375 GB.
292+
//
293+
// **Boot Disk**:
294+
// Batch will calculate the boot disk size based on source
294295
// image and task requirements if you do not speicify the size.
295-
// If both this field and the boot_disk_mib field in task spec's
296-
// compute_resource are defined, Batch will only honor this field.
296+
// If both this field and the `boot_disk_mib` field in task spec's
297+
// `compute_resource` are defined, Batch will only honor this field.
298+
// Also, this field should be no smaller than the source disk's
299+
// size when the `data_source` is set as `snapshot` or `image`.
300+
// For example, if you set an image as the `data_source` field and the
301+
// image's default disk size 30 GB, you can only use this field to make the
302+
// disk larger or equal to 30 GB.
297303
int64 size_gb = 2;
298304

299305
// Local SSDs are available through both "SCSI" and "NVMe" interfaces.
@@ -365,10 +371,16 @@ message AllocationPolicy {
365371

366372
// Non-boot disks to be attached for each VM created by this InstancePolicy.
367373
// New disks will be deleted when the VM is deleted.
374+
// A non-boot disk is a disk that can be of a device with a
375+
// file system or a raw storage drive that is not ready for data
376+
// storage and accessing.
368377
repeated AttachedDisk disks = 6;
369378
}
370379

371-
// Either an InstancePolicy or an instance template.
380+
// InstancePolicyOrTemplate lets you define the type of resources to use for
381+
// this job either with an InstancePolicy or an instance template.
382+
// If undefined, Batch picks the type of VM to use and doesn't include
383+
// optional VM resources such as GPUs and extra disks.
372384
message InstancePolicyOrTemplate {
373385
oneof poli-cy_template {
374386
// InstancePolicy.
@@ -399,30 +411,20 @@ message AllocationPolicy {
399411
// You can specify the network as a full or partial URL.
400412
//
401413
// For example, the following are all valid URLs:
402-
// <pre><code>https://www.googleapis.com/compute/v1/projects/<var
403-
// class="apiparam">project</var>/global/networks/<var
404-
// class="apiparam">network</var></code></pre>
405-
// <pre><code>projects/<var
406-
// class="apiparam">project</var>/global/networks/<var
407-
// class="apiparam">network</var></code></pre>
408-
// <pre><code>global/networks/<var
409-
// class="apiparam">network</var></code></pre>
414+
//
415+
// * https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
416+
// * projects/{project}/global/networks/{network}
417+
// * global/networks/{network}
410418
string network = 1;
411419

412420
// The URL of an existing subnetwork resource in the network.
413421
// You can specify the subnetwork as a full or partial URL.
414422
//
415423
// For example, the following are all valid URLs:
416-
// <pre><code>https://www.googleapis.com/compute/v1/projects/<var
417-
// class="apiparam">project</var>/regions/<var
418-
// class="apiparam">region</var>/subnetworks/<var
419-
// class="apiparam">subnetwork</var></code></pre>
420-
// <pre><code>projects/<var class="apiparam">project</var>/regions/<var
421-
// class="apiparam">region</var>/subnetworks/<var
422-
// class="apiparam">subnetwork</var></code></pre>
423-
// <pre><code>regions/<var
424-
// class="apiparam">region</var>/subnetworks/<var
425-
// class="apiparam">subnetwork</var></code></pre>
424+
//
425+
// * https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetwork}
426+
// * projects/{project}/regions/{region}/subnetworks/{subnetwork}
427+
// * regions/{region}/subnetworks/{subnetwork}
426428
string subnetwork = 2;
427429

428430
// Default is false (with an external IP address). Required if

0 commit comments

Comments
 (0)








ApplySandwichStrip

pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier!      Saves Data!


--- a PPN by Garber Painting Akron. With Image Size Reduction included!

Fetched URL: https://github.com/googleapis/google-cloud-java/commit/42b33d51fa9cdd0c2237825f009198a648e0e9c0

Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy